/ Developer CD Series 1997 February: Tool Chest / Dev.CD Feb 97 TC.toast / Sample Code / Development Tools & Languages / AppsToGo / •AppsToGo Reference / •AppsToGo Reference.rsrc / WFMT_528_a26E

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 05 00 01 00 00 00 1a | 00 00 00 00 00 00 00 1a |........|........|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 05 00 05 00 00 |........|........|
|00000030| 00 22 00 00 00 00 00 00 | 00 22 61 32 36 45 00 00 |."......|."a26E..|
|00000040| 4e 16 00 00 20 19 00 00 | 00 00 00 00 00 00 00 00 |N... ...|........|
|00000050| 00 00 08 4e 65 77 43 68 | 69 6c 64 00 00 06 00 00 |...NewCh|ild.....|
|00000060| 00 00 00 bf 00 00 00 00 | 00 00 00 bf 00 00 00 14 |........|........|
|00000070| 03 c1 00 28 05 7e 00 ff | 00 00 00 00 00 00 0f a8 |...(.~..|........|
|00000080| 00 00 00 00 4e 1c 00 00 | 00 09 00 00 00 04 00 04 |....N...|........|
|00000090| ff fc ff fa 00 04 00 04 | ff fc ff fc 00 00 00 00 |........|........|
|000000a0| 00 00 00 00 83 00 0b 40 | 10 6b 53 63 72 65 65 6e |.......@|.kScreen|
|000000b0| 41 50 49 2f 31 39 39 39 | 36 00 06 47 65 6e 65 76 |API/1999|6..Genev|
|000000c0| 61 00 00 65 54 72 65 65 | 4f 62 6a 48 6e 64 6c 20 |a..eTree|ObjHndl |
|000000d0| 4e 65 77 43 68 69 6c 64 | 28 73 68 6f 72 74 20 65 |NewChild|(short e|
|000000e0| 64 69 74 54 79 70 65 2c | 20 54 72 65 65 4f 62 6a |ditType,| TreeObj|
|000000f0| 48 6e 64 6c 20 70 61 72 | 65 6e 74 48 6e 64 6c 2c |Hndl par|entHndl,|
|00000100| 20 73 68 6f 72 74 20 63 | 68 69 6c 64 4e 75 6d 2c | short c|hildNum,|
|00000110| 20 73 68 6f 72 74 20 63 | 74 79 70 65 2c 20 6c 6f | short c|type, lo|
|00000120| 6e 67 20 73 69 7a 65 29 | 3b 00 00 00 06 00 00 00 |ng size)|;.......|
|00000130| 00 00 ac 00 00 00 00 00 | 00 00 ac 00 00 00 00 03 |........|........|
|00000140| c1 00 14 05 7e 00 ff 00 | 00 00 00 00 00 0f a8 00 |....~...|........|
|00000150| 00 00 00 4e 1d 00 00 00 | 09 00 00 00 04 00 04 ff |...N....|........|
|00000160| fc ff fa 00 04 00 04 ff | fc ff fc 00 00 00 00 00 |........|........|
|00000170| 00 00 00 83 00 0b 40 14 | 6b 53 63 72 65 65 6e 4f |......@.|kScreenO|
|00000180| 6e 65 4c 69 6e 65 2f 31 | 39 39 39 37 00 06 47 65 |neLine/1|9997..Ge|
|00000190| 6e 65 76 61 00 00 4e 43 | 72 65 61 74 65 73 20 61 |neva..NC|reates a|
|000001a0| 20 63 68 69 6c 64 20 6f | 66 20 73 70 65 63 69 66 | child o|f specif|
|000001b0| 69 65 64 20 74 79 70 65 | 20 61 6e 64 20 61 64 64 |ied type| and add|
|000001c0| 73 20 69 74 20 74 6f 20 | 70 61 72 65 6e 74 20 61 |s it to |parent a|
|000001d0| 74 20 73 70 65 63 69 66 | 69 65 64 20 6c 6f 63 61 |t specif|ied loca|
|000001e0| 74 69 6f 6e 2e 00 00 00 | 06 00 00 00 00 00 44 00 |tion....|......D.|
|000001f0| 00 00 00 00 00 00 44 00 | 00 00 00 02 6b 04 40 02 |......D.|....k.@.|
|00000200| 6c 01 00 00 00 00 00 00 | 01 0f f1 00 00 00 00 00 |l.......|........|
|00000210| 00 00 00 00 0c 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000220| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000230| 00 00 00 00 00 00 00 00 | 00 00 00 00 06 00 00 00 |........|........|
|00000240| 00 01 80 00 00 00 00 00 | 00 01 80 00 00 00 00 02 |........|........|
|00000250| 6b 02 28 03 c1 00 ff 00 | 00 00 00 00 00 0f a8 00 |k.(.....|........|
|00000260| 00 00 00 4e 16 00 00 00 | 09 00 00 00 04 00 04 ff |...N....|........|
|00000270| fc ff fa 00 04 00 04 ff | fc ff fc 00 00 00 00 00 |........|........|
|00000280| 00 00 00 83 00 0b 40 0b | 6c 69 6e 6b 73 2f 31 39 |......@.|links/19|
|00000290| 39 39 30 00 06 4d 6f 6e | 61 63 6f 00 01 15 61 31 |990..Mon|aco...a1|
|000002a0| 30 35 2c 41 64 6a 75 73 | 74 44 61 74 61 53 69 7a |05,Adjus|tDataSiz|
|000002b0| 65 0d 61 31 35 39 2c 43 | 6f 70 79 43 68 69 6c 64 |e.a159,C|opyChild|
|000002c0| 0d 61 31 42 31 2c 44 69 | 73 70 6f 73 65 43 68 69 |.a1B1,Di|sposeChi|
|000002d0| 6c 64 0d 61 31 44 41 2c | 44 6f 4e 75 6d 62 65 72 |ld.a1DA,|DoNumber|
|000002e0| 54 72 65 65 0d 61 31 45 | 33 2c 44 6f 54 72 65 65 |Tree.a1E|3,DoTree|
|000002f0| 4f 62 6a 4d 65 74 68 6f | 64 0d 61 32 30 38 2c 47 |ObjMetho|d.a208,G|
|00000300| 65 74 43 68 69 6c 64 48 | 6e 64 6c 0d 61 32 31 31 |etChildH|ndl.a211|
|00000310| 2c 47 65 74 44 61 74 61 | 50 74 72 0d 61 32 34 33 |,GetData|Ptr.a243|
|00000320| 2c 48 6e 64 6c 32 49 44 | 0d 61 32 34 41 2c 49 44 |,Hndl2ID|.a24A,ID|
|00000330| 32 48 6e 64 6c 0d 61 32 | 36 42 2c 4d 6f 64 69 66 |2Hndl.a2|6B,Modif|
|00000340| 79 43 68 69 6c 64 0d 61 | 32 36 43 2c 4d 6f 76 65 |yChild.a|26C,Move|
|00000350| 43 68 69 6c 64 0d 61 32 | 36 45 2c 4e 65 77 43 68 |Child.a2|6E,NewCh|
|00000360| 69 6c 64 0d 61 32 37 32 | 2c 4e 65 77 52 6f 6f 74 |ild.a272|,NewRoot|
|00000370| 4f 62 6a 0d 61 32 37 33 | 2c 4e 65 77 55 6e 64 6f |Obj.a273|,NewUndo|
|00000380| 0d 61 32 42 45 2c 53 65 | 74 44 61 74 61 53 69 7a |.a2BE,Se|tDataSiz|
|00000390| 65 0d 61 32 44 30 2c 53 | 6c 69 64 65 44 61 74 61 |e.a2D0,S|lideData|
|000003a0| 0d 61 32 44 37 2c 53 77 | 61 70 43 68 69 6c 64 72 |.a2D7,Sw|apChildr|
|000003b0| 65 6e 0d 00 16 00 01 00 | 00 00 00 00 10 00 0c 00 |en......|........|
|000003c0| 01 00 00 00 00 00 00 00 | 00 00 00 00 06 00 00 00 |........|........|
|000003d0| 00 44 a8 00 00 00 00 00 | 00 44 a8 00 00 00 00 00 |.D......|.D......|
|000003e0| 00 75 30 02 6b 01 ff 00 | 00 00 00 00 00 0f a8 00 |.u0.k...|........|
|000003f0| 00 00 00 4e 1f 00 00 00 | 09 00 00 00 04 00 04 ff |...N....|........|
|00000400| fc ff fa 00 04 00 04 ff | fc ff fc 00 00 00 00 00 |........|........|
|00000410| 00 00 00 83 00 0b 40 0a | 62 6f 64 79 2f 31 39 39 |......@.|body/199|
|00000420| 39 39 00 06 4d 6f 6e 61 | 63 6f 00 3c 46 54 72 65 |99..Mona|co.<FTre|
|00000430| 65 4f 62 6a 48 6e 64 6c | 20 4e 65 77 43 68 69 6c |eObjHndl| NewChil|
|00000440| 64 28 73 68 6f 72 74 20 | 65 64 69 74 54 79 70 65 |d(short |editType|
|00000450| 2c 20 54 72 65 65 4f 62 | 6a 48 6e 64 6c 20 70 61 |, TreeOb|jHndl pa|
|00000460| 72 65 6e 74 48 6e 64 6c | 2c 20 73 68 6f 72 74 20 |rentHndl|, short |
|00000470| 63 68 69 6c 64 4e 75 6d | 2c 20 73 68 6f 72 74 20 |childNum|, short |
|00000480| 63 74 79 70 65 2c 20 6c | 6f 6e 67 20 73 69 7a 65 |ctype, l|ong size|
|00000490| 29 3b 0d 0d 20 20 20 20 | 46 69 6c 65 3a 20 54 72 |);..    |File: Tr|
|000004a0| 65 65 4f 62 6a 2e 68 0d | 0d 43 72 65 61 74 65 73 |eeObj.h.|.Creates|
|000004b0| 20 61 20 63 68 69 6c 64 | 20 6f 66 20 73 70 65 63 | a child| of spec|
|000004c0| 69 66 69 65 64 20 74 79 | 70 65 20 61 6e 64 20 61 |ified ty|pe and a|
|000004d0| 64 64 73 20 69 74 20 74 | 6f 20 70 61 72 65 6e 74 |dds it t|o parent|
|000004e0| 20 61 74 20 73 70 65 63 | 69 66 69 65 64 20 6c 6f | at spec|ified lo|
|000004f0| 63 61 74 69 6f 6e 2e 0d | 52 65 74 75 72 6e 73 20 |cation..|Returns |
|00000500| 6e 69 6c 20 75 70 6f 6e | 20 66 61 69 6c 75 72 65 |nil upon| failure|
|00000510| 2e 0d 0d 4e 65 77 43 68 | 69 6c 64 20 69 73 20 6f |...NewCh|ild is o|
|00000520| 6e 65 20 6f 66 20 73 69 | 78 20 6f 70 65 72 61 74 |ne of si|x operat|
|00000530| 69 6f 6e 73 20 74 68 61 | 74 20 63 61 6e 20 62 65 |ions tha|t can be|
|00000540| 20 64 6f 6e 65 20 74 6f | 20 61 20 68 69 65 72 61 | done to| a hiera|
|00000550| 72 63 68 69 63 61 6c 20 | 64 6f 63 75 6d 65 6e 74 |rchical |document|
|00000560| 20 74 68 61 74 20 68 61 | 73 20 61 75 74 6f 6d 61 | that ha|s automa|
|00000570| 74 69 63 0d 75 6e 64 6f | 2f 72 65 64 6f 20 73 75 |tic.undo|/redo su|
|00000580| 70 70 6f 72 74 2e 20 20 | 54 68 65 20 73 69 78 20 |pport.  |The six |
|00000590| 6f 70 65 72 61 74 69 6f | 6e 73 20 61 72 65 3a 0d |operatio|ns are:.|
|000005a0| 0d 20 20 20 20 4e 65 77 | 43 68 69 6c 64 0d 20 20 |.    New|Child.  |
|000005b0| 20 20 44 69 73 70 6f 73 | 65 43 68 69 6c 64 0d 20 |  Dispos|eChild. |
|000005c0| 20 20 20 43 6f 70 79 43 | 68 69 6c 64 0d 20 20 20 |   CopyC|hild.   |
|000005d0| 20 4d 6f 76 65 43 68 69 | 6c 64 0d 20 20 20 20 4d | MoveChi|ld.    M|
|000005e0| 6f 64 69 66 79 43 68 69 | 6c 64 0d 20 20 20 20 53 |odifyChi|ld.    S|
|000005f0| 77 61 70 43 68 69 6c 64 | 72 65 6e 0d 0d 54 68 65 |wapChild|ren..The|
|00000600| 73 65 20 73 69 78 20 6f | 70 65 72 61 74 69 6f 6e |se six o|peration|
|00000610| 73 20 63 6f 76 65 72 20 | 74 68 65 20 76 61 72 69 |s cover |the vari|
|00000620| 6f 75 73 20 6f 70 65 72 | 61 74 69 6f 6e 73 20 74 |ous oper|ations t|
|00000630| 68 61 74 20 63 61 6e 20 | 62 65 20 70 65 72 66 6f |hat can |be perfo|
|00000640| 72 6d 65 64 20 74 6f 20 | 6f 6e 65 20 6f 72 20 6d |rmed to |one or m|
|00000650| 6f 72 65 20 6f 66 20 74 | 68 65 0d 64 6f 63 75 6d |ore of t|he.docum|
|00000660| 65 6e 74 20 6f 62 6a 65 | 63 74 73 2e 20 20 43 68 |ent obje|cts.  Ch|
|00000670| 69 6c 64 72 65 6e 20 63 | 61 6e 20 62 65 20 61 64 |ildren c|an be ad|
|00000680| 64 65 64 2c 20 72 65 6d | 6f 76 65 64 2c 20 63 6f |ded, rem|oved, co|
|00000690| 70 69 65 64 2c 20 6d 6f | 76 65 64 2c 20 6d 6f 64 |pied, mo|ved, mod|
|000006a0| 69 66 69 65 64 2c 20 6f | 72 20 73 77 61 70 70 65 |ified, o|r swappe|
|000006b0| 64 2e 20 20 49 66 20 74 | 68 65 73 65 0d 63 61 6c |d.  If t|hese.cal|
|000006c0| 6c 73 20 61 72 65 20 75 | 73 65 64 20 74 6f 20 6d |ls are u|sed to m|
|000006d0| 6f 64 69 66 79 20 6f 62 | 6a 65 63 74 73 20 77 69 |odify ob|jects wi|
|000006e0| 74 68 69 6e 20 74 68 65 | 20 64 6f 63 75 6d 65 6e |thin the| documen|
|000006f0| 74 20 68 69 65 72 61 72 | 63 68 79 2c 20 74 68 65 |t hierar|chy, the|
|00000700| 6e 20 74 68 65 20 65 64 | 69 74 69 6e 67 20 6f 70 |n the ed|iting op|
|00000710| 65 72 61 74 69 6f 6e 73 | 20 64 6f 6e 65 20 74 6f |erations| done to|
|00000720| 0d 74 68 65 20 64 6f 63 | 75 6d 65 6e 74 20 63 61 |.the doc|ument ca|
|00000730| 6e 20 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 20 |n automa|tically |
|00000740| 62 65 20 72 65 63 6f 72 | 64 65 64 20 66 6f 72 20 |be recor|ded for |
|00000750| 75 6e 64 6f 2f 72 65 64 | 6f 20 70 75 72 70 6f 73 |undo/red|o purpos|
|00000760| 65 73 2e 0d 0d 54 6f 20 | 62 65 74 74 65 72 20 75 |es...To |better u|
|00000770| 6e 64 65 72 73 74 61 6e | 64 20 74 68 65 20 68 69 |nderstan|d the hi|
|00000780| 65 72 61 72 63 68 69 63 | 61 6c 20 64 6f 63 75 6d |erarchic|al docum|
|00000790| 65 6e 74 20 61 72 63 68 | 69 74 65 63 74 75 72 65 |ent arch|itecture|
|000007a0| 2c 20 77 65 20 77 69 6c | 6c 20 74 61 6c 6b 20 61 |, we wil|l talk a|
|000007b0| 62 6f 75 74 20 6d 6f 72 | 65 20 74 68 61 6e 20 6a |bout mor|e than j|
|000007c0| 75 73 74 0d 4e 65 77 43 | 68 69 6c 64 20 68 65 72 |ust.NewC|hild her|
|000007d0| 65 2e 20 20 53 69 6e 63 | 65 20 6d 61 6e 79 20 6f |e.  Sinc|e many o|
|000007e0| 66 20 74 68 65 20 66 75 | 6e 63 74 69 6f 6e 20 69 |f the fu|nction i|
|000007f0| 6e 74 65 72 2d 72 65 6c | 61 74 65 2c 20 69 74 20 |nter-rel|ate, it |
|00000800| 69 73 20 62 65 73 74 20 | 74 6f 20 64 69 73 63 75 |is best |to discu|
|00000810| 73 73 20 74 68 65 6d 20 | 69 6e 20 61 20 67 72 6f |ss them |in a gro|
|00000820| 75 70 0d 61 74 20 73 6f | 6d 65 20 70 6f 69 6e 74 |up.at so|me point|
|00000830| 2e 0d 0d 4c 6f 6f 6b 69 | 6e 67 20 61 74 20 61 20 |...Looki|ng at a |
|00000840| 73 61 6d 70 6c 65 20 4e | 65 77 43 68 69 6c 64 20 |sample N|ewChild |
|00000850| 63 61 6c 6c 20 61 6e 64 | 20 69 74 73 20 70 72 6f |call and| its pro|
|00000860| 74 6f 74 79 70 65 2c 20 | 77 65 20 68 61 76 65 3a |totype, |we have:|
|00000870| 0d 0d 4e 65 77 43 68 69 | 6c 64 2c 20 69 66 20 73 |..NewChi|ld, if s|
|00000880| 75 63 63 65 73 73 66 75 | 6c 2c 20 72 65 74 75 72 |uccessfu|l, retur|
|00000890| 6e 73 20 61 20 68 61 6e | 64 6c 65 20 66 6f 72 20 |ns a han|dle for |
|000008a0| 74 68 65 20 63 68 69 6c | 64 20 6f 62 6a 65 63 74 |the chil|d object|
|000008b0| 20 61 64 64 65 64 20 74 | 6f 20 74 68 65 20 64 6f | added t|o the do|
|000008c0| 63 75 6d 65 6e 74 2e 0d | 0d 54 68 65 20 70 61 72 |cument..|.The par|
|000008d0| 61 6d 65 74 65 72 73 20 | 61 72 65 3a 0d 20 20 20 |ameters |are:.   |
|000008e0| 20 65 64 69 74 54 79 70 | 65 3a 20 20 20 41 70 70 | editTyp|e:   App|
|000008f0| 6c 69 63 61 74 69 6f 6e | 20 65 64 69 74 20 74 79 |lication| edit ty|
|00000900| 70 65 20 66 6f 72 20 77 | 68 69 63 68 20 74 68 69 |pe for w|hich thi|
|00000910| 73 20 64 6f 63 75 6d 65 | 6e 74 20 6d 6f 64 69 66 |s docume|nt modif|
|00000920| 69 63 61 74 69 6f 6e 20 | 69 73 20 62 65 69 6e 67 |ication |is being|
|00000930| 20 64 6f 6e 65 2e 0d 20 | 20 20 20 70 61 72 65 6e | done.. |   paren|
|00000940| 74 48 6e 64 6c 3a 20 54 | 68 65 20 63 68 69 6c 64 |tHndl: T|he child|
|00000950| 20 63 72 65 61 74 65 64 | 20 77 69 6c 6c 20 62 65 | created| will be|
|00000960| 20 61 64 64 65 64 20 61 | 73 20 61 20 63 68 69 6c | added a|s a chil|
|00000970| 64 20 74 6f 20 74 68 69 | 73 20 6f 62 6a 65 63 74 |d to thi|s object|
|00000980| 2e 0d 20 20 20 20 63 68 | 69 6c 64 4e 75 6d 3a 20 |..    ch|ildNum: |
|00000990| 20 20 54 68 65 20 63 68 | 69 6c 64 20 77 69 6c 6c |  The ch|ild will|
|000009a0| 20 62 65 20 61 64 64 65 | 64 20 74 6f 20 74 68 65 | be adde|d to the|
|000009b0| 20 70 61 72 65 6e 74 20 | 61 73 20 74 68 69 73 20 | parent |as this |
|000009c0| 63 68 69 6c 64 20 6e 75 | 6d 62 65 72 2e 0d 20 20 |child nu|mber..  |
|000009d0| 20 20 63 74 79 70 65 3a | 20 20 20 20 20 20 54 68 |  ctype:|      Th|
|000009e0| 65 20 63 68 69 6c 64 20 | 77 69 6c 6c 20 62 65 20 |e child |will be |
|000009f0| 6f 66 20 74 68 69 73 20 | 74 79 70 65 2e 0d 20 20 |of this |type..  |
|00000a00| 20 20 73 69 7a 65 3a 20 | 20 20 20 20 20 20 54 68 |  size: |      Th|
|00000a10| 65 20 63 68 69 6c 64 20 | 77 69 6c 6c 20 62 65 20 |e child |will be |
|00000a20| 63 72 65 61 74 65 64 20 | 74 68 69 73 20 69 6e 69 |created |this ini|
|00000a30| 74 69 61 6c 20 73 69 7a | 65 20 28 69 66 20 73 69 |tial siz|e (if si|
|00000a40| 7a 65 20 69 73 20 67 72 | 65 61 74 65 72 20 74 68 |ze is gr|eater th|
|00000a50| 61 6e 20 6d 69 6e 69 6d | 75 6d 29 2e 0d 0d 4e 65 |an minim|um)...Ne|
|00000a60| 77 43 68 69 6c 64 20 6d | 75 73 74 20 68 61 76 65 |wChild m|ust have|
|00000a70| 20 61 20 70 61 72 65 6e | 74 20 64 65 63 6c 61 72 | a paren|t declar|
|00000a80| 65 64 2e 20 20 54 68 69 | 73 20 62 65 67 73 20 74 |ed.  Thi|s begs t|
|00000a90| 68 65 20 71 75 65 73 74 | 69 6f 6e 20 6f 66 20 77 |he quest|ion of w|
|00000aa0| 68 65 72 65 20 74 68 65 | 20 69 6e 69 74 69 61 6c |here the| initial|
|00000ab0| 20 70 61 72 65 6e 74 20 | 63 6f 6d 65 73 20 66 72 | parent |comes fr|
|00000ac0| 6f 6d 2e 0d 41 74 20 73 | 6f 6d 65 20 70 6f 69 6e |om..At s|ome poin|
|00000ad0| 74 2c 20 4e 65 77 52 6f | 6f 74 4f 62 6a 20 6d 75 |t, NewRo|otObj mu|
|00000ae0| 73 74 20 62 65 20 63 61 | 6c 6c 65 64 20 74 6f 20 |st be ca|lled to |
|00000af0| 63 72 65 61 74 65 20 74 | 68 65 20 69 6e 69 74 69 |create t|he initi|
|00000b00| 61 6c 20 72 6f 6f 74 20 | 70 61 72 65 6e 74 2e 20 |al root |parent. |
|00000b10| 20 41 73 20 77 6f 75 6c | 64 20 62 65 20 65 78 70 | As woul|d be exp|
|00000b20| 65 63 74 65 64 2c 0d 74 | 68 65 20 72 6f 6f 74 20 |ected,.t|he root |
|00000b30| 6f 62 6a 65 63 74 20 68 | 61 73 20 6e 6f 20 70 61 |object h|as no pa|
|00000b40| 72 65 6e 74 2e 20 20 4f | 6e 63 65 20 74 68 65 72 |rent.  O|nce ther|
|00000b50| 65 20 69 73 20 61 6e 20 | 69 6e 69 74 69 61 6c 20 |e is an |initial |
|00000b60| 72 6f 6f 74 20 6f 62 6a | 65 63 74 2c 20 63 68 69 |root obj|ect, chi|
|00000b70| 6c 64 72 65 6e 20 63 61 | 6e 20 74 68 65 6e 20 62 |ldren ca|n then b|
|00000b80| 65 20 61 64 64 65 64 20 | 74 6f 0d 74 68 65 20 64 |e added |to.the d|
|00000b90| 6f 63 75 6d 65 6e 74 20 | 76 69 61 20 4e 65 77 43 |ocument |via NewC|
|00000ba0| 68 69 6c 64 2e 0d 0d 54 | 68 65 20 65 64 69 74 54 |hild...T|he editT|
|00000bb0| 79 70 65 20 6f 66 20 74 | 68 65 20 4e 65 77 43 68 |ype of t|he NewCh|
|00000bc0| 69 6c 64 20 63 61 6c 6c | 20 69 73 20 75 73 65 64 |ild call| is used|
|00000bd0| 20 66 6f 72 20 61 75 74 | 6f 6d 61 74 69 63 61 6c | for aut|omatical|
|00000be0| 6c 79 20 74 72 61 63 6b | 69 6e 67 20 75 6e 64 6f |ly track|ing undo|
|00000bf0| 2f 72 65 64 6f 2e 20 20 | 4d 61 6e 79 20 69 6e 64 |/redo.  |Many ind|
|00000c00| 69 76 69 64 75 61 6c 0d | 6f 70 65 72 61 74 69 6f |ividual.|operatio|
|00000c10| 6e 73 20 6d 61 79 20 62 | 65 20 64 6f 6e 65 20 74 |ns may b|e done t|
|00000c20| 6f 20 74 68 65 20 64 6f | 63 75 6d 65 6e 74 20 74 |o the do|cument t|
|00000c30| 68 61 74 20 61 72 65 20 | 61 6c 6c 20 66 6f 72 20 |hat are |all for |
|00000c40| 74 68 65 20 73 61 6d 65 | 20 65 64 69 74 69 6e 67 |the same| editing|
|00000c50| 20 6f 70 65 72 61 74 69 | 6f 6e 2e 20 20 4c 65 74 | operati|on.  Let|
|00000c60| 27 73 20 73 61 79 20 74 | 68 61 74 0d 79 6f 75 20 |'s say t|hat.you |
|00000c70| 68 61 76 65 20 61 20 77 | 6f 72 64 2d 70 72 6f 63 |have a w|ord-proc|
|00000c80| 65 73 73 6f 72 20 61 70 | 70 6c 69 63 61 74 69 6f |essor ap|plicatio|
|00000c90| 6e 20 74 68 61 74 20 68 | 61 73 20 70 61 72 61 67 |n that h|as parag|
|00000ca0| 72 61 70 68 20 6f 62 6a | 65 63 74 73 2e 20 20 49 |raph obj|ects.  I|
|00000cb0| 66 20 79 6f 75 72 20 64 | 6f 63 75 6d 65 6e 74 20 |f your d|ocument |
|00000cc0| 68 61 73 20 32 37 0d 70 | 61 72 61 67 72 61 70 68 |has 27.p|aragraph|
|00000cd0| 73 2c 20 74 68 65 6e 20 | 79 6f 75 20 68 61 76 65 |s, then |you have|
|00000ce0| 20 32 37 20 63 68 69 6c | 64 72 65 6e 20 6f 66 66 | 27 chil|dren off|
|00000cf0| 20 74 68 65 20 72 6f 6f | 74 20 6f 62 6a 65 63 74 | the roo|t object|
|00000d00| 2e 20 20 54 68 65 20 6f | 72 64 65 72 20 6f 66 20 |.  The o|rder of |
|00000d10| 74 68 65 20 63 68 69 6c | 64 72 65 6e 20 69 73 20 |the chil|dren is |
|00000d20| 74 68 65 20 6f 72 64 65 | 72 0d 6f 66 20 74 68 65 |the orde|r.of the|
|00000d30| 20 70 61 72 61 67 72 61 | 70 68 73 20 69 6e 20 79 | paragra|phs in y|
|00000d40| 6f 75 72 20 64 6f 63 75 | 6d 65 6e 74 2e 0d 0d 4c |our docu|ment...L|
|00000d50| 65 74 27 73 20 6e 6f 77 | 20 73 61 79 20 74 68 61 |et's now| say tha|
|00000d60| 74 20 74 68 65 20 75 73 | 65 72 20 68 61 73 20 73 |t the us|er has s|
|00000d70| 65 6c 65 63 74 65 64 20 | 73 6f 6d 65 20 74 65 78 |elected |some tex|
|00000d80| 74 2e 20 20 54 68 65 20 | 74 65 78 74 20 73 65 6c |t.  The |text sel|
|00000d90| 65 63 74 65 64 20 73 74 | 61 72 74 73 20 69 6e 20 |ected st|arts in |
|00000da0| 74 68 65 20 6d 69 64 64 | 6c 65 20 6f 66 0d 70 61 |the midd|le of.pa|
|00000db0| 72 61 67 72 61 70 68 20 | 33 2c 20 67 6f 65 73 20 |ragraph |3, goes |
|00000dc0| 74 68 72 6f 75 67 68 20 | 70 61 72 61 67 72 61 70 |through |paragrap|
|00000dd0| 68 73 20 34 2d 35 2c 20 | 61 6e 64 20 74 68 72 6f |hs 4-5, |and thro|
|00000de0| 75 67 68 20 68 61 6c 66 | 20 6f 66 20 74 68 65 20 |ugh half| of the |
|00000df0| 74 65 78 74 20 69 6e 20 | 70 61 72 61 67 72 61 70 |text in |paragrap|
|00000e00| 68 20 36 2e 20 20 54 68 | 65 20 75 73 65 72 0d 74 |h 6.  Th|e user.t|
|00000e10| 68 65 6e 20 64 65 6c 65 | 74 65 73 20 74 68 69 73 |hen dele|tes this|
|00000e20| 20 74 65 78 74 2e 20 20 | 57 65 20 6d 61 79 20 68 | text.  |We may h|
|00000e30| 61 76 65 20 64 65 63 6c | 61 72 65 64 20 74 68 69 |ave decl|ared thi|
|00000e40| 73 20 74 79 70 65 20 6f | 66 20 65 64 69 74 20 74 |s type o|f edit t|
|00000e50| 6f 20 62 65 20 6f 66 20 | 74 79 70 65 20 44 45 4c |o be of |type DEL|
|00000e60| 45 54 45 5f 45 44 49 54 | 2e 0d 54 68 65 20 65 64 |ETE_EDIT|..The ed|
|00000e70| 69 74 73 20 74 6f 20 74 | 68 65 20 64 6f 63 75 6d |its to t|he docum|
|00000e80| 65 6e 74 20 74 68 61 74 | 20 77 65 20 77 69 6c 6c |ent that| we will|
|00000e90| 20 70 65 72 66 6f 72 6d | 20 61 72 65 3a 0d 0d 31 | perform| are:..1|
|00000ea0| 29 20 4d 6f 64 69 66 79 | 20 70 61 72 61 67 72 61 |) Modify| paragra|
|00000eb0| 70 68 20 33 20 62 79 20 | 72 65 6d 6f 76 69 6e 67 |ph 3 by |removing|
|00000ec0| 20 74 68 65 20 73 65 6c | 65 63 74 65 64 20 74 65 | the sel|ected te|
|00000ed0| 78 74 20 61 6e 64 20 6b | 65 65 70 69 6e 67 20 74 |xt and k|eeping t|
|00000ee0| 68 65 20 75 6e 73 65 6c | 65 63 74 65 64 20 74 65 |he unsel|ected te|
|00000ef0| 78 74 2e 0d 32 29 20 44 | 65 6c 65 74 65 20 70 61 |xt..2) D|elete pa|
|00000f00| 72 61 67 72 61 70 68 73 | 20 34 2d 35 2e 0d 33 29 |ragraphs| 4-5..3)|
|00000f10| 20 4d 6f 64 69 66 79 20 | 70 61 72 61 67 72 61 70 | Modify |paragrap|
|00000f20| 68 20 36 20 62 79 20 72 | 65 6d 6f 76 69 6e 67 20 |h 6 by r|emoving |
|00000f30| 74 68 65 20 73 65 6c 65 | 63 74 65 64 20 74 65 78 |the sele|cted tex|
|00000f40| 74 20 61 6e 64 20 6b 65 | 65 70 69 6e 67 20 74 68 |t and ke|eping th|
|00000f50| 65 20 75 6e 73 65 6c 65 | 63 74 65 64 20 74 65 78 |e unsele|cted tex|
|00000f60| 74 2e 0d 0d 46 6f 72 20 | 73 74 65 70 20 31 2c 20 |t...For |step 1, |
|00000f70| 77 65 20 77 6f 75 6c 64 | 20 66 69 72 73 74 20 75 |we would| first u|
|00000f80| 73 65 20 4d 6f 64 69 66 | 79 43 68 69 6c 64 2e 20 |se Modif|yChild. |
|00000f90| 20 54 68 65 20 70 72 6f | 74 6f 74 79 70 65 20 66 | The pro|totype f|
|00000fa0| 6f 72 20 4d 6f 64 69 66 | 79 43 68 69 6c 64 20 69 |or Modif|yChild i|
|00000fb0| 73 3a 0d 0d 20 20 20 20 | 4f 53 45 72 72 20 20 20 |s:..    |OSErr   |
|00000fc0| 4d 6f 64 69 66 79 43 68 | 69 6c 64 28 73 68 6f 72 |ModifyCh|ild(shor|
|00000fd0| 74 20 65 64 69 74 54 79 | 70 65 2c 20 54 72 65 65 |t editTy|pe, Tree|
|00000fe0| 4f 62 6a 48 6e 64 6c 20 | 70 68 6e 64 6c 2c 20 73 |ObjHndl |phndl, s|
|00000ff0| 68 6f 72 74 20 63 68 69 | 6c 64 4e 75 6d 2c 20 42 |hort chi|ldNum, B|
|00001000| 6f 6f 6c 65 61 6e 20 64 | 65 65 70 43 6f 70 79 29 |oolean d|eepCopy)|
|00001010| 3b 0d 0d 4d 6f 64 69 66 | 79 43 68 69 6c 64 20 6d |;..Modif|yChild m|
|00001020| 61 6b 65 73 20 61 20 63 | 6f 70 79 20 6f 66 20 74 |akes a c|opy of t|
|00001030| 68 65 20 6f 62 6a 65 63 | 74 20 61 6e 64 20 70 6c |he objec|t and pl|
|00001040| 61 63 65 73 20 74 68 65 | 20 63 6f 70 79 20 69 6e |aces the| copy in|
|00001050| 20 74 68 65 20 75 6e 64 | 6f 20 68 69 65 72 61 72 | the und|o hierar|
|00001060| 63 68 79 2e 20 20 57 65 | 20 61 72 65 20 6e 6f 77 |chy.  We| are now|
|00001070| 20 66 72 65 65 0d 74 6f | 20 6d 6f 64 69 66 79 20 | free.to| modify |
|00001080| 74 68 65 20 6f 62 6a 65 | 63 74 20 61 6e 79 20 77 |the obje|ct any w|
|00001090| 61 79 20 77 65 20 73 65 | 65 20 66 69 74 2e 20 20 |ay we se|e fit.  |
|000010a0| 49 66 20 74 68 65 20 75 | 73 65 72 20 63 68 6f 6f |If the u|ser choo|
|000010b0| 73 65 73 20 74 6f 20 75 | 6e 64 6f 20 74 68 65 20 |ses to u|ndo the |
|000010c0| 63 68 61 6e 67 65 2c 20 | 74 68 65 20 75 6e 64 6f |change, |the undo|
|000010d0| 20 63 6f 64 65 0d 73 69 | 6d 70 6c 79 20 73 77 61 | code.si|mply swa|
|000010e0| 70 73 20 74 68 65 20 64 | 61 74 61 20 6f 66 20 74 |ps the d|ata of t|
|000010f0| 68 65 20 6d 6f 64 69 66 | 69 65 64 20 6f 62 6a 65 |he modif|ied obje|
|00001100| 63 74 20 77 69 74 68 20 | 74 68 65 20 63 6f 70 79 |ct with |the copy|
|00001110| 20 74 68 61 74 20 77 61 | 73 20 73 61 76 65 64 20 | that wa|s saved |
|00001120| 69 6e 20 74 68 65 20 75 | 6e 64 6f 20 68 69 65 72 |in the u|ndo hier|
|00001130| 61 72 63 68 79 2e 0d 49 | 66 20 74 68 65 20 75 73 |archy..I|f the us|
|00001140| 65 72 20 6c 61 74 65 72 | 20 63 68 6f 6f 73 65 73 |er later| chooses|
|00001150| 20 74 6f 20 72 65 64 6f | 20 74 68 65 20 65 64 69 | to redo| the edi|
|00001160| 74 2c 20 74 68 65 20 75 | 6e 64 6f 20 63 6f 64 65 |t, the u|ndo code|
|00001170| 20 73 69 6d 70 6c 79 20 | 73 77 61 70 73 20 74 68 | simply |swaps th|
|00001180| 65 20 64 61 74 61 20 61 | 67 61 69 6e 20 74 6f 20 |e data a|gain to |
|00001190| 70 65 72 66 6f 72 6d 0d | 74 68 65 20 72 65 64 6f |perform.|the redo|
|000011a0| 2e 0d 0d 4e 4f 54 45 3a | 20 20 4d 6f 64 69 66 79 |...NOTE:|  Modify|
|000011b0| 43 68 69 6c 64 20 6d 61 | 79 20 66 61 69 6c 2c 20 |Child ma|y fail, |
|000011c0| 73 69 6e 63 65 20 61 20 | 63 6f 70 79 20 6f 66 20 |since a |copy of |
|000011d0| 74 68 65 20 6f 62 6a 65 | 63 74 20 69 73 20 6d 61 |the obje|ct is ma|
|000011e0| 64 65 2e 20 20 54 68 65 | 72 65 20 6d 61 79 20 6e |de.  The|re may n|
|000011f0| 6f 74 20 62 65 20 65 6e | 6f 75 67 68 20 6d 65 6d |ot be en|ough mem|
|00001200| 6f 72 79 0d 20 20 20 20 | 20 20 20 66 6f 72 20 74 |ory.    |   for t|
|00001210| 68 69 73 20 63 6f 70 79 | 20 74 6f 20 62 65 20 63 |his copy| to be c|
|00001220| 72 65 61 74 65 64 2e 20 | 20 49 66 20 74 68 69 73 |reated. | If this|
|00001230| 20 69 73 20 73 6f 2c 20 | 74 68 65 6e 20 6d 65 6d | is so, |then mem|
|00001240| 46 75 6c 6c 45 72 72 20 | 77 69 6c 6c 20 62 65 20 |FullErr |will be |
|00001250| 72 65 74 75 72 6e 65 64 | 2e 0d 0d 54 68 65 20 70 |returned|...The p|
|00001260| 61 72 61 6d 65 74 65 72 | 73 20 61 72 65 3a 0d 20 |arameter|s are:. |
|00001270| 20 20 20 65 64 69 74 54 | 79 70 65 3a 20 20 20 41 |   editT|ype:   A|
|00001280| 70 70 6c 69 63 61 74 69 | 6f 6e 20 65 64 69 74 20 |pplicati|on edit |
|00001290| 74 79 70 65 20 66 6f 72 | 20 77 68 69 63 68 20 74 |type for| which t|
|000012a0| 68 69 73 20 64 6f 63 75 | 6d 65 6e 74 20 6d 6f 64 |his docu|ment mod|
|000012b0| 69 66 69 63 61 74 69 6f | 6e 20 69 73 20 62 65 69 |ificatio|n is bei|
|000012c0| 6e 67 20 64 6f 6e 65 2e | 0d 20 20 20 20 70 61 72 |ng done.|.    par|
|000012d0| 65 6e 74 48 6e 64 6c 3a | 20 50 61 72 65 6e 74 20 |entHndl:| Parent |
|000012e0| 6f 66 20 74 68 65 20 63 | 68 69 6c 64 20 62 65 69 |of the c|hild bei|
|000012f0| 6e 67 20 6d 6f 64 69 66 | 69 65 64 2e 0d 20 20 20 |ng modif|ied..   |
|00001300| 20 63 68 69 6c 64 4e 75 | 6d 3a 20 20 20 43 68 69 | childNu|m:   Chi|
|00001310| 6c 64 20 6e 75 6d 62 65 | 72 20 28 6f 66 20 74 68 |ld numbe|r (of th|
|00001320| 65 20 70 61 72 65 6e 74 | 29 20 62 65 69 6e 67 20 |e parent|) being |
|00001330| 6d 6f 64 69 66 69 65 64 | 2e 0d 20 20 20 20 64 65 |modified|..    de|
|00001340| 65 70 43 6f 70 79 3a 20 | 20 20 49 66 20 74 72 75 |epCopy: |  If tru|
|00001350| 65 2c 20 74 68 65 20 63 | 68 69 6c 64 72 65 6e 20 |e, the c|hildren |
|00001360| 6f 66 20 74 68 69 73 20 | 63 68 69 6c 64 20 61 72 |of this |child ar|
|00001370| 65 20 61 6c 73 6f 20 63 | 6f 70 69 65 64 20 69 6e |e also c|opied in|
|00001380| 74 6f 20 74 68 65 20 75 | 6e 64 6f 20 68 69 65 72 |to the u|ndo hier|
|00001390| 61 72 63 68 79 2e 0d 0d | 54 68 65 20 65 64 69 74 |archy...|The edit|
|000013a0| 54 79 70 65 20 70 61 72 | 61 6d 65 74 65 72 20 69 |Type par|ameter i|
|000013b0| 73 20 75 73 65 64 20 74 | 6f 20 64 65 74 65 72 6d |s used t|o determ|
|000013c0| 69 6e 65 20 69 66 20 74 | 68 69 73 20 64 6f 63 75 |ine if t|his docu|
|000013d0| 6d 65 6e 74 20 6d 6f 64 | 69 66 69 63 61 74 69 6f |ment mod|ificatio|
|000013e0| 6e 20 69 73 20 6f 66 20 | 74 68 65 20 73 61 6d 65 |n is of |the same|
|000013f0| 0d 65 64 69 74 20 74 79 | 70 65 20 61 73 20 70 72 |.edit ty|pe as pr|
|00001400| 65 76 69 6f 75 73 20 64 | 6f 63 75 6d 65 6e 74 20 |evious d|ocument |
|00001410| 6d 6f 64 69 66 69 63 61 | 74 69 6f 6e 73 2e 20 20 |modifica|tions.  |
|00001420| 49 66 20 69 74 20 69 73 | 2c 20 74 68 65 6e 20 74 |If it is|, then t|
|00001430| 68 65 20 6f 70 65 72 61 | 74 69 6f 6e 20 69 73 20 |he opera|tion is |
|00001440| 67 72 6f 75 70 65 64 0d | 77 69 74 68 20 74 68 65 |grouped.|with the|
|00001450| 20 6f 74 68 65 72 20 6f | 70 65 72 61 74 69 6f 6e | other o|peration|
|00001460| 73 2e 20 20 54 68 69 73 | 20 69 73 20 61 6c 6c 20 |s.  This| is all |
|00001470| 64 6f 6e 65 20 66 6f 72 | 20 74 68 65 20 70 75 72 |done for| the pur|
|00001480| 70 6f 73 65 73 20 6f 66 | 20 75 6e 64 6f 2f 72 65 |poses of| undo/re|
|00001490| 64 6f 2e 20 20 4d 75 6c | 74 69 70 6c 65 20 6f 62 |do.  Mul|tiple ob|
|000014a0| 6a 65 63 74 73 0d 6d 61 | 79 20 62 65 20 6d 6f 64 |jects.ma|y be mod|
|000014b0| 69 66 69 65 64 20 69 6e | 20 61 20 73 69 6e 67 6c |ified in| a singl|
|000014c0| 65 20 65 64 69 74 2c 20 | 61 6e 64 20 74 68 65 73 |e edit, |and thes|
|000014d0| 65 20 6d 6f 64 69 66 69 | 63 61 74 69 6f 6e 73 20 |e modifi|cations |
|000014e0| 61 6c 6c 20 68 61 76 65 | 20 74 6f 20 62 65 20 75 |all have| to be u|
|000014f0| 6e 64 6f 6e 65 2f 72 65 | 64 6f 6e 65 20 77 69 74 |ndone/re|done wit|
|00001500| 68 0d 61 20 73 69 6e 67 | 6c 65 20 75 6e 64 6f 2f |h.a sing|le undo/|
|00001510| 72 65 64 6f 2e 0d 0d 49 | 66 20 74 68 65 20 65 64 |redo...I|f the ed|
|00001520| 69 74 54 79 70 65 20 69 | 73 20 64 69 66 66 65 72 |itType i|s differ|
|00001530| 65 6e 74 20 74 68 61 6e | 20 74 68 65 20 6c 61 73 |ent than| the las|
|00001540| 74 20 64 6f 63 75 6d 65 | 6e 74 20 6d 6f 64 69 66 |t docume|nt modif|
|00001550| 69 63 61 74 69 6f 6e 2c | 20 74 68 65 6e 20 61 20 |ication,| then a |
|00001560| 6e 65 77 20 75 6e 64 6f | 20 67 72 6f 75 70 20 69 |new undo| group i|
|00001570| 73 0d 73 74 61 72 74 65 | 64 2c 20 61 6e 64 20 74 |s.starte|d, and t|
|00001580| 68 69 73 20 6f 70 65 72 | 61 74 69 6f 6e 20 69 73 |his oper|ation is|
|00001590| 20 72 65 63 6f 72 64 65 | 64 20 69 6e 20 74 68 69 | recorde|d in thi|
|000015a0| 73 20 6e 65 77 20 67 72 | 6f 75 70 2e 0d 0d 46 6f |s new gr|oup...Fo|
|000015b0| 72 20 74 68 65 20 61 62 | 6f 76 65 20 65 78 61 6d |r the ab|ove exam|
|000015c0| 70 6c 65 2c 20 77 65 20 | 77 6f 75 6c 64 20 6d 61 |ple, we |would ma|
|000015d0| 6b 65 20 74 68 65 20 66 | 6f 6c 6c 6f 77 69 6e 67 |ke the f|ollowing|
|000015e0| 20 63 61 6c 6c 20 74 6f | 20 4d 6f 64 69 66 79 43 | call to| ModifyC|
|000015f0| 68 69 6c 64 20 70 72 69 | 6f 72 20 74 6f 20 72 65 |hild pri|or to re|
|00001600| 6d 6f 76 69 6e 67 0d 74 | 68 65 20 73 65 6c 65 63 |moving.t|he selec|
|00001610| 74 65 64 20 74 65 78 74 | 20 66 72 6f 6d 20 70 61 |ted text| from pa|
|00001620| 72 61 67 72 61 70 68 20 | 33 3a 0d 0d 20 20 20 20 |ragraph |3:..    |
|00001630| 65 72 72 20 3d 20 4d 6f | 64 69 66 79 43 68 69 6c |err = Mo|difyChil|
|00001640| 64 28 44 45 4c 45 54 45 | 5f 45 44 49 54 2c 20 72 |d(DELETE|_EDIT, r|
|00001650| 6f 6f 74 2c 20 33 2c 20 | 66 61 6c 73 65 29 3b 0d |oot, 3, |false);.|
|00001660| 0d 4f 66 20 63 6f 75 72 | 73 65 2c 20 69 74 20 77 |.Of cour|se, it w|
|00001670| 6f 75 6c 64 20 62 65 20 | 61 20 72 65 61 6c 6c 79 |ould be |a really|
|00001680| 20 6f 64 64 20 61 70 70 | 6c 69 63 61 74 69 6f 6e | odd app|lication|
|00001690| 20 69 6e 20 77 68 69 63 | 68 20 74 68 65 20 27 33 | in whic|h the '3|
|000016a0| 27 20 77 61 73 20 68 61 | 72 64 2d 63 6f 64 65 64 |' was ha|rd-coded|
|000016b0| 20 61 73 20 69 6e 0d 74 | 68 65 20 61 62 6f 76 65 | as in.t|he above|
|000016c0| 20 6c 69 6e 65 2e 0d 0d | 4e 6f 77 20 70 61 72 61 | line...|Now para|
|000016d0| 67 72 61 70 68 73 20 34 | 20 61 6e 64 20 35 20 6e |graphs 4| and 5 n|
|000016e0| 65 65 64 20 74 6f 20 62 | 65 20 64 65 6c 65 74 65 |eed to b|e delete|
|000016f0| 64 2e 20 20 54 68 69 73 | 20 69 73 20 64 6f 6e 65 |d.  This| is done|
|00001700| 20 62 79 20 75 73 69 6e | 67 20 44 69 73 70 6f 73 | by usin|g Dispos|
|00001710| 65 43 68 69 6c 64 2e 0d | 54 68 65 20 70 72 6f 74 |eChild..|The prot|
|00001720| 6f 74 79 70 65 20 66 6f | 72 20 44 69 73 70 6f 73 |otype fo|r Dispos|
|00001730| 65 43 68 69 6c 64 20 69 | 73 3a 0d 20 20 20 20 76 |eChild i|s:.    v|
|00001740| 6f 69 64 20 20 20 20 44 | 69 73 70 6f 73 65 43 68 |oid    D|isposeCh|
|00001750| 69 6c 64 28 73 68 6f 72 | 74 20 65 64 69 74 54 79 |ild(shor|t editTy|
|00001760| 70 65 2c 20 54 72 65 65 | 4f 62 6a 48 6e 64 6c 20 |pe, Tree|ObjHndl |
|00001770| 70 61 72 65 6e 74 48 6e | 64 6c 2c 20 73 68 6f 72 |parentHn|dl, shor|
|00001780| 74 20 63 68 69 6c 64 4e | 75 6d 29 3b 0d 0d 4e 6f |t childN|um);..No|
|00001790| 74 65 20 74 68 61 74 20 | 44 69 73 70 6f 73 65 43 |te that |DisposeC|
|000017a0| 68 69 6c 64 20 77 69 6c | 6c 20 73 75 63 63 65 65 |hild wil|l succee|
|000017b0| 64 2c 20 61 73 20 69 74 | 20 64 6f 65 73 6e 27 74 |d, as it| doesn't|
|000017c0| 20 68 61 76 65 20 74 6f | 20 63 72 65 61 74 65 20 | have to| create |
|000017d0| 61 20 6e 65 77 20 68 61 | 6e 64 6c 65 20 66 6f 72 |a new ha|ndle for|
|000017e0| 20 74 68 65 0d 63 6f 70 | 79 20 61 73 20 4d 6f 64 | the.cop|y as Mod|
|000017f0| 69 66 79 43 68 69 6c 64 | 20 64 6f 65 73 2e 20 20 |ifyChild| does.  |
|00001800| 48 4f 57 45 56 45 52 3a | 20 20 44 69 73 70 6f 73 |HOWEVER:|  Dispos|
|00001810| 65 43 68 69 6c 64 20 64 | 6f 65 73 6e 27 74 20 6e |eChild d|oesn't n|
|00001820| 65 63 65 73 73 61 72 69 | 6c 79 20 66 72 65 65 20 |ecessari|ly free |
|00001830| 75 70 20 72 61 6d 2c 20 | 61 73 0d 79 6f 75 20 77 |up ram, |as.you w|
|00001840| 6f 75 6c 64 20 65 78 70 | 65 63 74 2e 20 20 41 6c |ould exp|ect.  Al|
|00001850| 6c 20 74 68 61 74 20 6f | 63 63 75 72 73 20 69 73 |l that o|ccurs is|
|00001860| 20 74 68 61 74 20 74 68 | 65 20 63 68 69 6c 64 20 | that th|e child |
|00001870| 69 73 20 6d 6f 76 65 64 | 20 69 6e 74 6f 20 74 68 |is moved| into th|
|00001880| 65 20 75 6e 64 6f 20 68 | 69 65 72 61 72 63 68 79 |e undo h|ierarchy|
|00001890| 20 73 6f 0d 74 68 61 74 | 20 75 6e 64 6f 20 63 61 | so.that| undo ca|
|000018a0| 6e 20 6d 6f 76 65 20 74 | 68 65 20 63 68 69 6c 64 |n move t|he child|
|000018b0| 20 62 61 63 6b 20 69 6e | 74 6f 20 74 68 65 20 64 | back in|to the d|
|000018c0| 6f 63 75 6d 65 6e 74 2e | 0d 0d 54 6f 20 64 65 6c |ocument.|..To del|
|000018d0| 65 74 65 20 63 68 69 6c | 64 72 65 6e 20 34 20 61 |ete chil|dren 4 a|
|000018e0| 6e 64 20 35 2c 20 77 65 | 20 77 6f 75 6c 64 20 64 |nd 5, we| would d|
|000018f0| 6f 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 3a |o the fo|llowing:|
|00001900| 0d 0d 20 20 20 20 44 69 | 73 70 6f 73 65 43 68 69 |..    Di|sposeChi|
|00001910| 6c 64 28 44 45 4c 45 54 | 45 5f 45 44 49 54 2c 20 |ld(DELET|E_EDIT, |
|00001920| 72 6f 6f 74 2c 20 34 29 | 3b 0d 20 20 20 20 44 69 |root, 4)|;.    Di|
|00001930| 73 70 6f 73 65 43 68 69 | 6c 64 28 44 45 4c 45 54 |sposeChi|ld(DELET|
|00001940| 45 5f 45 44 49 54 2c 20 | 72 6f 6f 74 2c 20 34 29 |E_EDIT, |root, 4)|
|00001950| 3b 0d 0d 4e 6f 74 65 20 | 74 68 61 74 20 66 6f 72 |;..Note |that for|
|00001960| 20 62 6f 74 68 20 63 61 | 6c 6c 73 20 77 65 20 64 | both ca|lls we d|
|00001970| 69 73 70 6f 73 65 20 6f | 66 20 63 68 69 6c 64 20 |ispose o|f child |
|00001980| 6e 75 6d 62 65 72 20 34 | 2e 20 20 54 68 69 73 20 |number 4|.  This |
|00001990| 69 73 20 62 65 63 61 75 | 73 65 20 6f 6e 63 65 20 |is becau|se once |
|000019a0| 74 68 65 20 66 69 72 73 | 74 20 63 68 69 6c 64 0d |the firs|t child.|
|000019b0| 69 73 20 64 69 73 70 6f | 73 65 64 20 6f 66 2c 20 |is dispo|sed of, |
|000019c0| 77 68 61 74 20 75 73 65 | 64 20 74 6f 20 62 65 20 |what use|d to be |
|000019d0| 63 68 69 6c 64 20 35 20 | 69 73 20 6e 6f 77 20 63 |child 5 |is now c|
|000019e0| 68 69 6c 64 20 34 2e 0d | 0d 54 68 65 20 6c 61 73 |hild 4..|.The las|
|000019f0| 74 20 6f 70 65 72 61 74 | 69 6f 6e 20 77 65 20 77 |t operat|ion we w|
|00001a00| 6f 75 6c 64 20 64 6f 20 | 69 73 20 74 6f 20 64 65 |ould do |is to de|
|00001a10| 63 6c 61 72 65 20 6f 75 | 72 20 69 6e 74 65 6e 74 |clare ou|r intent|
|00001a20| 20 74 6f 20 63 68 61 6e | 67 65 20 74 6f 20 74 68 | to chan|ge to th|
|00001a30| 65 20 65 6e 64 20 63 68 | 69 6c 64 20 69 6e 20 74 |e end ch|ild in t|
|00001a40| 68 65 0d 73 65 6c 65 63 | 74 69 6f 6e 20 72 61 6e |he.selec|tion ran|
|00001a50| 67 65 2e 20 20 54 68 69 | 73 20 77 6f 75 6c 64 20 |ge.  Thi|s would |
|00001a60| 62 65 20 64 6f 6e 65 20 | 61 73 20 66 6f 6c 6c 6f |be done |as follo|
|00001a70| 77 73 3a 0d 20 20 20 20 | 65 72 72 20 3d 20 4d 6f |ws:.    |err = Mo|
|00001a80| 64 69 66 79 43 68 69 6c | 64 28 44 45 4c 45 54 45 |difyChil|d(DELETE|
|00001a90| 5f 45 44 49 54 2c 20 72 | 6f 6f 74 2c 20 34 2c 20 |_EDIT, r|oot, 4, |
|00001aa0| 66 61 6c 73 65 29 3b 0d | 0d 54 68 65 20 64 65 6c |false);.|.The del|
|00001ab0| 65 74 65 20 28 61 73 73 | 75 6d 69 6e 67 20 6e 6f |ete (ass|uming no|
|00001ac0| 20 65 72 72 6f 72 73 29 | 20 68 61 73 20 6e 6f 77 | errors)| has now|
|00001ad0| 20 62 65 65 6e 20 63 6f | 6d 70 6c 65 74 65 64 2e | been co|mpleted.|
|00001ae0| 20 20 41 63 74 75 61 6c | 6c 79 2c 20 74 68 65 20 |  Actual|ly, the |
|00001af0| 64 65 6c 65 74 65 20 68 | 61 73 20 6f 63 63 75 72 |delete h|as occur|
|00001b00| 72 65 64 0d 69 6e 20 65 | 69 74 68 65 72 20 63 61 |red.in e|ither ca|
|00001b10| 73 65 2e 20 20 49 66 20 | 74 68 65 72 65 20 77 65 |se.  If |there we|
|00001b20| 72 65 20 65 72 72 6f 72 | 73 2c 20 61 6c 6c 20 74 |re error|s, all t|
|00001b30| 68 61 74 20 6f 63 63 75 | 72 72 65 64 20 69 73 20 |hat occu|rred is |
|00001b40| 74 68 61 74 20 74 68 65 | 20 75 6e 64 6f 20 69 6e |that the| undo in|
|00001b50| 66 6f 72 6d 61 74 69 6f | 6e 20 77 61 73 6e 27 74 |formatio|n wasn't|
|00001b60| 0d 72 65 63 6f 72 64 65 | 64 2e 0d 0d 4e 6f 77 20 |.recorde|d...Now |
|00001b70| 6c 65 74 27 73 20 73 61 | 79 20 74 68 61 74 20 74 |let's sa|y that t|
|00001b80| 68 65 20 75 73 65 72 20 | 73 65 6c 65 63 74 73 20 |he user |selects |
|00001b90| 61 20 6e 65 77 20 72 61 | 6e 67 65 20 6f 66 20 74 |a new ra|nge of t|
|00001ba0| 65 78 74 20 61 6e 64 20 | 64 65 6c 65 74 65 73 20 |ext and |deletes |
|00001bb0| 69 74 2c 20 61 73 20 77 | 65 6c 6c 2e 20 20 57 65 |it, as w|ell.  We|
|00001bc0| 20 77 6f 75 6c 64 0d 64 | 6f 20 74 68 65 20 73 61 | would.d|o the sa|
|00001bd0| 6d 65 20 74 68 69 6e 67 | 20 61 73 20 61 62 6f 76 |me thing| as abov|
|00001be0| 65 20 74 6f 20 64 65 6c | 65 74 65 20 74 68 65 20 |e to del|ete the |
|00001bf0| 74 65 78 74 2e 20 20 48 | 65 72 65 27 73 20 74 68 |text.  H|ere's th|
|00001c00| 65 20 70 72 6f 62 6c 65 | 6d 3a 20 20 54 68 65 20 |e proble|m:  The |
|00001c10| 65 64 69 74 54 79 70 65 | 20 6f 66 20 74 68 69 73 |editType| of this|
|00001c20| 0d 73 65 63 6f 6e 64 20 | 74 65 78 74 20 64 65 6c |.second |text del|
|00001c30| 65 74 65 20 69 73 20 74 | 68 65 20 73 61 6d 65 20 |ete is t|he same |
|00001c40| 61 73 20 74 68 65 20 66 | 69 72 73 74 2e 20 20 42 |as the f|irst.  B|
|00001c50| 6f 74 68 20 64 6f 63 75 | 6d 65 6e 74 20 65 64 69 |oth docu|ment edi|
|00001c60| 74 73 20 77 65 72 65 20 | 6f 66 20 74 79 70 65 20 |ts were |of type |
|00001c70| 44 45 4c 45 54 45 5f 45 | 44 49 54 2e 0d 54 68 69 |DELETE_E|DIT..Thi|
|00001c80| 73 20 6d 65 61 6e 73 20 | 74 68 61 74 20 62 6f 74 |s means |that bot|
|00001c90| 68 20 6f 70 65 72 61 74 | 69 6f 6e 73 20 77 65 72 |h operat|ions wer|
|00001ca0| 65 20 72 65 63 6f 72 64 | 65 64 20 75 6e 64 65 72 |e record|ed under|
|00001cb0| 20 74 68 65 20 73 61 6d | 65 20 75 6e 64 6f 20 74 | the sam|e undo t|
|00001cc0| 61 73 6b 2e 20 20 57 68 | 65 6e 20 74 68 65 20 75 |ask.  Wh|en the u|
|00001cd0| 73 65 72 0d 63 68 6f 6f | 73 65 73 20 75 6e 64 6f |ser.choo|ses undo|
|00001ce0| 2c 20 62 6f 74 68 20 64 | 65 6c 65 74 65 73 20 77 |, both d|eletes w|
|00001cf0| 69 6c 6c 20 62 65 20 75 | 6e 64 6f 6e 65 2e 20 20 |ill be u|ndone.  |
|00001d00| 54 68 69 73 20 69 73 6e | 27 74 20 77 68 61 74 20 |This isn|'t what |
|00001d10| 77 65 20 77 61 6e 74 2e | 0d 0d 54 6f 20 66 69 78 |we want.|..To fix|
|00001d20| 20 74 68 69 73 20 70 72 | 6f 62 6c 65 6d 2c 20 77 | this pr|oblem, w|
|00001d30| 65 20 68 61 76 65 20 74 | 6f 20 6d 61 6b 65 20 6f |e have t|o make o|
|00001d40| 6e 65 20 61 64 64 69 74 | 69 6f 6e 61 6c 20 63 61 |ne addit|ional ca|
|00001d50| 6c 6c 2e 20 20 57 65 20 | 6e 65 65 64 20 74 6f 20 |ll.  We |need to |
|00001d60| 63 61 6c 6c 20 4e 65 77 | 55 6e 64 6f 2e 0d 4e 65 |call New|Undo..Ne|
|00001d70| 77 55 6e 64 6f 20 63 6c | 6f 73 65 73 20 6f 75 74 |wUndo cl|oses out|
|00001d80| 20 74 68 65 20 6f 6c 64 | 20 65 64 69 74 69 6e 67 | the old| editing|
|00001d90| 20 74 61 73 6b 2e 20 20 | 57 68 65 6e 20 79 6f 75 | task.  |When you|
|00001da0| 20 74 68 65 6e 20 6d 61 | 6b 65 20 73 6f 6d 65 20 | then ma|ke some |
|00001db0| 64 6f 63 75 6d 65 6e 74 | 20 6d 6f 64 69 66 69 63 |document| modific|
|00001dc0| 61 74 69 6f 6e 2c 0d 69 | 74 20 77 69 6c 6c 20 62 |ation,.i|t will b|
|00001dd0| 65 20 72 65 63 6f 72 64 | 65 64 20 69 6e 20 61 20 |e record|ed in a |
|00001de0| 73 65 70 61 72 61 74 65 | 20 75 6e 64 6f 20 74 61 |separate| undo ta|
|00001df0| 73 6b 2e 0d 0d 4e 65 77 | 55 6e 64 6f 20 6f 6e 6c |sk...New|Undo onl|
|00001e00| 79 20 74 61 6b 65 73 20 | 61 20 73 69 6e 67 6c 65 |y takes |a single|
|00001e10| 20 70 61 72 61 6d 65 74 | 65 72 2e 20 20 4a 75 73 | paramet|er.  Jus|
|00001e20| 74 20 70 61 73 73 20 69 | 74 20 61 6e 79 20 68 61 |t pass i|t any ha|
|00001e30| 6e 64 6c 65 20 69 6e 20 | 74 68 65 20 64 6f 63 75 |ndle in |the docu|
|00001e40| 6d 65 6e 74 2e 20 20 41 | 6e 79 0d 6f 62 6a 65 63 |ment.  A|ny.objec|
|00001e50| 74 20 69 6e 20 74 68 65 | 20 64 6f 63 75 6d 65 6e |t in the| documen|
|00001e60| 74 20 63 61 6e 20 73 65 | 72 76 65 20 61 73 20 61 |t can se|rve as a|
|00001e70| 20 72 65 66 65 72 65 6e | 63 65 20 74 6f 20 74 68 | referen|ce to th|
|00001e80| 65 20 64 6f 63 75 6d 65 | 6e 74 2e 0d 0d 0d 41 6e |e docume|nt....An|
|00001e90| 20 6f 62 6a 65 63 74 20 | 68 61 6e 64 6c 65 20 68 | object |handle h|
|00001ea0| 61 73 20 33 20 70 61 72 | 74 73 3a 0d 31 29 20 54 |as 3 par|ts:.1) T|
|00001eb0| 68 65 20 68 65 61 64 65 | 72 20 69 6e 66 6f 72 6d |he heade|r inform|
|00001ec0| 61 74 69 6f 6e 2e 0d 32 | 29 20 54 68 65 20 61 70 |ation..2|) The ap|
|00001ed0| 70 6c 69 63 61 74 69 6f | 6e 2d 64 65 66 69 6e 65 |plicatio|n-define|
|00001ee0| 64 20 6f 62 6a 65 63 74 | 20 64 61 74 61 2e 0d 33 |d object| data..3|
|00001ef0| 29 20 54 68 65 20 63 68 | 69 6c 64 20 68 61 6e 64 |) The ch|ild hand|
|00001f00| 6c 65 20 74 61 62 6c 65 | 2e 0d 0d 0d 54 68 65 20 |le table|....The |
|00001f10| 6f 62 6a 65 63 74 20 68 | 65 61 64 65 72 20 69 73 |object h|eader is|
|00001f20| 20 6f 66 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e | of the |followin|
|00001f30| 67 20 66 6f 72 6d 3a 0d | 0d 74 79 70 65 64 65 66 |g form:.|.typedef|
|00001f40| 20 73 74 72 75 63 74 20 | 54 72 65 65 4f 62 6a 20 | struct |TreeObj |
|00001f50| 7b 0d 20 20 20 20 73 68 | 6f 72 74 20 20 20 20 20 |{.    sh|ort     |
|00001f60| 20 20 74 79 70 65 3b 0d | 20 20 20 20 73 68 6f 72 |  type;.|    shor|
|00001f70| 74 20 20 20 20 20 20 20 | 6e 75 6d 43 68 69 6c 64 |t       |numChild|
|00001f80| 72 65 6e 3b 0d 20 20 20 | 20 6c 6f 6e 67 20 20 20 |ren;.   | long   |
|00001f90| 20 20 20 20 20 64 61 74 | 61 53 69 7a 65 3b 0d 20 |     dat|aSize;. |
|00001fa0| 20 20 20 6c 6f 6e 67 20 | 20 20 20 20 20 20 20 74 |   long |       t|
|00001fb0| 72 65 65 49 44 3b 0d 20 | 20 20 20 54 72 65 65 4f |reeID;. |   TreeO|
|00001fc0| 62 6a 48 6e 64 6c 20 70 | 61 72 65 6e 74 3b 0d 7d |bjHndl p|arent;.}|
|00001fd0| 20 54 72 65 65 4f 62 6a | 3b 0d 0d 54 68 65 73 65 | TreeObj|;..These|
|00001fe0| 20 66 69 65 6c 64 73 20 | 61 72 65 20 61 75 74 6f | fields |are auto|
|00001ff0| 6d 61 74 69 63 61 6c 6c | 79 20 66 69 6c 6c 65 64 |maticall|y filled|
|00002000| 20 6f 75 74 20 77 68 65 | 6e 65 76 65 72 20 61 6e | out whe|never an|
|00002010| 20 6f 62 6a 65 63 74 20 | 69 73 20 63 72 65 61 74 | object |is creat|
|00002020| 65 64 20 76 69 61 20 4e | 65 77 52 6f 6f 74 4f 62 |ed via N|ewRootOb|
|00002030| 6a 0d 6f 72 20 4e 65 77 | 43 68 69 6c 64 2e 0d 0d |j.or New|Child...|
|00002040| 54 68 65 20 61 70 70 6c | 69 63 61 74 69 6f 6e 2d |The appl|ication-|
|00002050| 64 65 66 69 6e 65 64 20 | 64 61 74 61 20 61 72 65 |defined |data are|
|00002060| 61 20 69 73 20 61 75 74 | 6f 6d 61 74 69 63 61 6c |a is aut|omatical|
|00002070| 6c 79 20 69 6e 69 74 69 | 61 6c 69 7a 65 64 20 77 |ly initi|alized w|
|00002080| 69 74 68 20 30 27 73 2e | 20 20 57 68 65 6e 20 4e |ith 0's.|  When N|
|00002090| 65 77 52 6f 6f 74 4f 62 | 6a 0d 6f 72 20 4e 65 77 |ewRootOb|j.or New|
|000020a0| 43 68 69 6c 64 20 69 73 | 20 63 61 6c 6c 65 64 2c |Child is| called,|
|000020b0| 20 61 20 73 69 7a 65 20 | 70 61 72 61 6d 65 74 65 | a size |paramete|
|000020c0| 72 20 69 73 20 70 61 73 | 73 65 64 20 69 6e 2e 20 |r is pas|sed in. |
|000020d0| 20 54 68 65 72 65 20 69 | 73 20 61 6c 73 6f 20 61 | There i|s also a|
|000020e0| 20 74 61 62 6c 65 20 6f | 66 20 6d 69 6e 69 6d 75 | table o|f minimu|
|000020f0| 6d 20 73 69 7a 65 73 0d | 66 6f 72 20 65 61 63 68 |m sizes.|for each|
|00002100| 20 6f 62 6a 65 63 74 20 | 74 79 70 65 20 74 68 61 | object |type tha|
|00002110| 74 20 6e 65 65 64 73 20 | 74 6f 20 62 65 20 64 65 |t needs |to be de|
|00002120| 66 69 6e 65 64 2e 20 20 | 49 66 20 74 68 65 20 73 |fined.  |If the s|
|00002130| 69 7a 65 20 70 61 73 73 | 65 64 20 69 6e 20 69 73 |ize pass|ed in is|
|00002140| 20 73 6d 61 6c 6c 65 72 | 20 74 68 61 6e 20 74 68 | smaller| than th|
|00002150| 65 0d 6d 69 6e 69 6d 75 | 6d 20 73 69 7a 65 2c 20 |e.minimu|m size, |
|00002160| 74 68 65 6e 20 74 68 65 | 20 6d 69 6e 69 6d 75 6d |then the| minimum|
|00002170| 20 73 69 7a 65 20 69 73 | 20 75 73 65 64 20 61 73 | size is| used as|
|00002180| 20 74 68 65 20 64 61 74 | 61 20 73 69 7a 65 20 69 | the dat|a size i|
|00002190| 6e 73 74 65 61 64 2e 0d | 0d 54 68 65 20 6d 69 6e |nstead..|.The min|
|000021a0| 69 6d 75 6d 20 73 69 7a | 65 20 74 61 62 6c 65 20 |imum siz|e table |
|000021b0| 69 73 20 61 20 67 6c 6f | 62 61 6c 20 61 72 72 61 |is a glo|bal arra|
|000021c0| 79 20 6f 66 20 6c 6f 6e | 67 73 20 63 61 6c 6c 65 |y of lon|gs calle|
|000021d0| 64 20 67 4d 69 6e 54 72 | 65 65 4f 62 6a 53 69 7a |d gMinTr|eeObjSiz|
|000021e0| 65 2e 20 20 49 74 73 20 | 64 65 66 69 6e 69 74 69 |e.  Its |definiti|
|000021f0| 6f 6e 20 69 73 0d 66 6f | 75 6e 64 20 69 6e 20 46 |on is.fo|und in F|
|00002200| 69 6c 65 2e 63 2e 20 20 | 46 6f 72 20 65 61 63 68 |ile.c.  |For each|
|00002210| 20 74 79 70 65 20 6f 66 | 20 6f 62 6a 65 63 74 20 | type of| object |
|00002220| 64 65 66 69 6e 65 64 2c | 20 74 68 65 72 65 20 6e |defined,| there n|
|00002230| 65 65 64 73 20 74 6f 20 | 62 65 20 61 20 6d 69 6e |eeds to |be a min|
|00002240| 69 6d 75 6d 20 73 69 7a | 65 20 64 65 66 69 6e 65 |imum siz|e define|
|00002250| 64 2e 0d 0d 54 68 65 72 | 65 20 61 72 65 20 73 6f |d...Ther|e are so|
|00002260| 6d 65 20 70 72 65 64 65 | 66 69 6e 65 64 20 6f 62 |me prede|fined ob|
|00002270| 6a 65 63 74 20 74 79 70 | 65 73 2e 20 20 54 68 65 |ject typ|es.  The|
|00002280| 73 65 20 61 72 65 20 64 | 65 66 69 6e 65 64 20 62 |se are d|efined b|
|00002290| 79 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 3a |y the fo|llowing:|
|000022a0| 0d 0d 23 64 65 66 69 6e | 65 20 52 4f 4f 54 4f 42 |..#defin|e ROOTOB|
|000022b0| 4a 20 20 20 20 20 31 0d | 23 64 65 66 69 6e 65 20 |J     1.|#define |
|000022c0| 55 4e 44 4f 4f 42 4a 20 | 20 20 20 20 32 0d 23 64 |UNDOOBJ |    2.#d|
|000022d0| 65 66 69 6e 65 20 55 4e | 44 4f 54 41 53 4b 4f 42 |efine UN|DOTASKOB|
|000022e0| 4a 20 33 0d 23 64 65 66 | 69 6e 65 20 55 4e 44 4f |J 3.#def|ine UNDO|
|000022f0| 50 41 52 54 4f 42 4a 20 | 34 0d 23 64 65 66 69 6e |PARTOBJ |4.#defin|
|00002300| 65 20 57 46 4d 54 4f 42 | 4a 20 20 20 20 20 35 0d |e WFMTOB|J     5.|
|00002310| 23 64 65 66 69 6e 65 20 | 43 54 4c 4f 42 4a 20 20 |#define |CTLOBJ  |
|00002320| 20 20 20 20 36 0d 0d 54 | 68 65 73 65 20 61 72 65 |    6..T|hese are|
|00002330| 20 74 68 65 20 6d 61 6e | 64 61 74 6f 72 79 20 6f | the man|datory o|
|00002340| 62 6a 65 63 74 20 74 79 | 70 65 73 20 66 6f 72 20 |bject ty|pes for |
|00002350| 73 75 70 70 6f 72 74 69 | 6e 67 20 74 68 69 73 20 |supporti|ng this |
|00002360| 69 6d 70 6c 65 6d 65 6e | 74 61 74 69 6f 6e 20 6f |implemen|tation o|
|00002370| 66 20 74 68 65 20 64 6f | 63 75 6d 65 6e 74 0d 73 |f the do|cument.s|
|00002380| 74 72 75 63 74 75 72 65 | 20 61 6e 64 20 75 6e 64 |tructure| and und|
|00002390| 6f 2f 72 65 64 6f 20 66 | 65 61 74 75 72 65 73 2e |o/redo f|eatures.|
|000023a0| 0d 0d 41 70 70 6c 69 63 | 61 74 69 6f 6e 2d 64 65 |..Applic|ation-de|
|000023b0| 66 69 6e 65 64 20 6f 62 | 6a 65 63 74 20 74 79 70 |fined ob|ject typ|
|000023c0| 65 73 20 63 61 6e 20 73 | 74 61 72 74 20 77 69 74 |es can s|tart wit|
|000023d0| 68 20 74 79 70 65 20 6e | 75 6d 62 65 72 20 31 36 |h type n|umber 16|
|000023e0| 2e 20 20 54 79 70 65 20 | 6e 75 6d 62 65 72 20 30 |.  Type |number 0|
|000023f0| 20 69 73 20 72 65 73 65 | 72 76 65 64 0d 61 6e 64 | is rese|rved.and|
|00002400| 20 69 73 20 63 75 72 72 | 65 6e 74 6c 79 20 75 6e | is curr|ently un|
|00002410| 64 65 66 69 6e 65 64 2e | 20 20 54 79 70 65 73 20 |defined.|  Types |
|00002420| 37 2d 31 35 20 61 72 65 | 20 72 65 73 65 72 76 65 |7-15 are| reserve|
|00002430| 64 20 66 6f 72 20 66 75 | 74 75 72 65 20 6f 62 6a |d for fu|ture obj|
|00002440| 65 63 74 73 20 74 68 61 | 74 20 6d 61 79 20 62 65 |ects tha|t may be|
|00002450| 20 61 64 64 65 64 0d 74 | 6f 20 74 68 65 20 44 54 | added.t|o the DT|
|00002460| 53 2e 4c 69 62 20 61 70 | 70 6c 69 63 61 74 69 6f |S.Lib ap|plicatio|
|00002470| 6e 20 66 72 61 6d 65 77 | 6f 72 6b 2e 0d 0d 54 68 |n framew|ork...Th|
|00002480| 65 20 6e 75 6d 43 68 69 | 6c 64 72 65 6e 20 66 69 |e numChi|ldren fi|
|00002490| 65 6c 64 20 69 73 20 69 | 6e 69 74 69 61 6c 6c 79 |eld is i|nitially|
|000024a0| 20 30 20 61 66 74 65 72 | 20 63 61 6c 6c 69 6e 67 | 0 after| calling|
|000024b0| 20 65 69 74 68 65 72 20 | 4e 65 77 52 6f 6f 74 4f | either |NewRootO|
|000024c0| 62 6a 20 6f 72 20 4e 65 | 77 43 68 69 6c 64 2e 0d |bj or Ne|wChild..|
|000024d0| 0d 54 68 65 20 64 61 74 | 61 53 69 7a 65 20 69 73 |.The dat|aSize is|
|000024e0| 20 74 68 65 20 65 66 66 | 65 63 74 69 76 65 20 64 | the eff|ective d|
|000024f0| 61 74 61 20 73 69 7a 65 | 20 61 66 74 65 72 20 6f |ata size| after o|
|00002500| 62 6a 65 63 74 20 63 72 | 65 61 74 69 6f 6e 2c 20 |bject cr|eation, |
|00002510| 77 68 69 63 68 20 69 73 | 20 65 69 74 68 65 72 20 |which is| either |
|00002520| 74 68 65 20 73 69 7a 65 | 20 70 61 73 73 65 64 0d |the size| passed.|
|00002530| 69 6e 2c 20 6f 72 20 74 | 68 65 20 6d 69 6e 69 6d |in, or t|he minim|
|00002540| 75 6d 20 6f 62 6a 65 63 | 74 20 73 69 7a 65 2c 20 |um objec|t size, |
|00002550| 77 68 69 63 68 65 76 65 | 72 20 69 73 20 67 72 65 |whicheve|r is gre|
|00002560| 61 74 65 72 2e 0d 0d 54 | 68 65 20 74 72 65 65 49 |ater...T|he treeI|
|00002570| 44 20 66 69 65 6c 64 20 | 69 73 20 69 6e 69 74 69 |D field |is initi|
|00002580| 61 6c 6c 79 20 73 65 74 | 20 74 6f 20 30 20 62 79 |ally set| to 0 by|
|00002590| 20 62 6f 74 68 20 4e 65 | 77 52 6f 6f 74 4f 62 6a | both Ne|wRootObj|
|000025a0| 20 61 6e 64 20 4e 65 77 | 43 68 69 6c 64 2e 20 20 | and New|Child.  |
|000025b0| 54 68 69 73 20 66 69 65 | 6c 64 20 69 73 0d 75 73 |This fie|ld is.us|
|000025c0| 65 64 20 74 6f 20 75 6e | 69 71 75 65 6c 79 20 69 |ed to un|iquely i|
|000025d0| 64 65 6e 74 69 66 79 20 | 6d 65 6d 62 65 72 73 20 |dentify |members |
|000025e0| 6f 66 20 74 68 65 20 68 | 69 65 72 61 72 63 68 79 |of the h|ierarchy|
|000025f0| 20 62 79 20 49 44 2e 20 | 20 28 4d 6f 72 65 20 6f | by ID. | (More o|
|00002600| 6e 20 74 68 69 73 20 6c | 61 74 65 72 2e 29 0d 0d |n this l|ater.)..|
|00002610| 54 68 65 20 70 61 72 65 | 6e 74 20 66 69 65 6c 64 |The pare|nt field|
|00002620| 20 69 73 20 61 20 72 65 | 66 65 72 65 6e 63 65 20 | is a re|ference |
|00002630| 74 6f 20 74 68 65 20 68 | 61 6e 64 6c 65 20 77 68 |to the h|andle wh|
|00002640| 69 63 68 20 69 73 20 74 | 68 65 20 70 61 72 65 6e |ich is t|he paren|
|00002650| 74 2e 20 20 41 73 20 79 | 6f 75 20 77 6f 75 6c 64 |t.  As y|ou would|
|00002660| 20 65 78 70 65 63 74 2c | 0d 6f 62 6a 65 63 74 73 | expect,|.objects|
|00002670| 20 63 72 65 61 74 65 64 | 20 62 79 20 4e 65 77 52 | created| by NewR|
|00002680| 6f 6f 74 4f 62 6a 20 68 | 61 76 65 20 6e 6f 20 70 |ootObj h|ave no p|
|00002690| 61 72 65 6e 74 2c 20 61 | 6e 64 20 74 68 65 72 65 |arent, a|nd there|
|000026a0| 66 6f 72 65 20 74 68 69 | 73 20 66 69 65 6c 64 20 |fore thi|s field |
|000026b0| 69 73 20 6e 69 6c 2e 0d | 0d 0d 54 68 65 20 61 70 |is nil..|..The ap|
|000026c0| 70 6c 69 63 61 74 69 6f | 6e 2d 64 65 66 69 6e 65 |plicatio|n-define|
|000026d0| 64 20 64 61 74 61 20 61 | 72 65 61 20 73 74 61 72 |d data a|rea star|
|000026e0| 74 73 20 69 6d 6d 65 64 | 69 61 74 65 6c 79 20 61 |ts immed|iately a|
|000026f0| 66 74 65 72 20 74 68 65 | 20 68 65 61 64 65 72 20 |fter the| header |
|00002700| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 2e 20 20 41 73 |informat|ion.  As|
|00002710| 20 74 68 65 0d 73 74 72 | 75 63 74 75 72 65 20 6f | the.str|ucture o|
|00002720| 66 20 74 68 69 73 20 70 | 6f 72 74 69 6f 6e 20 69 |f this p|ortion i|
|00002730| 73 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 2d 64 65 |s applic|ation-de|
|00002740| 66 69 6e 65 64 20 61 6e | 64 20 76 61 72 69 61 6e |fined an|d varian|
|00002750| 74 2c 20 74 68 65 72 65 | 20 69 73 20 6e 6f 20 73 |t, there| is no s|
|00002760| 74 72 75 63 74 75 72 65 | 20 70 72 65 2d 64 65 66 |tructure| pre-def|
|00002770| 69 6e 65 64 0d 66 6f 72 | 20 69 74 2e 20 20 45 61 |ined.for| it.  Ea|
|00002780| 63 68 20 6f 62 6a 65 63 | 74 20 74 79 70 65 20 77 |ch objec|t type w|
|00002790| 69 6c 6c 20 68 61 76 65 | 20 61 20 75 6e 69 71 75 |ill have| a uniqu|
|000027a0| 65 20 73 74 72 75 63 74 | 75 72 65 20 64 65 66 69 |e struct|ure defi|
|000027b0| 6e 69 74 69 6f 6e 20 66 | 6f 72 20 74 68 69 73 20 |nition f|or this |
|000027c0| 70 6f 72 74 69 6f 6e 20 | 6f 66 20 74 68 65 20 6f |portion |of the o|
|000027d0| 62 6a 65 63 74 2e 0d 0d | 0d 54 68 65 20 66 69 6e |bject...|.The fin|
|000027e0| 61 6c 20 70 61 72 74 20 | 6f 66 20 61 6e 20 6f 62 |al part |of an ob|
|000027f0| 6a 65 63 74 20 69 73 20 | 74 68 65 20 63 68 69 6c |ject is |the chil|
|00002800| 64 20 68 61 6e 64 6c 65 | 20 74 61 62 6c 65 2e 20 |d handle| table. |
|00002810| 20 54 68 65 20 63 68 69 | 6c 64 20 68 61 6e 64 6c | The chi|ld handl|
|00002820| 65 20 74 61 62 6c 65 20 | 73 74 61 72 74 73 0d 69 |e table |starts.i|
|00002830| 6d 6d 65 64 69 61 74 65 | 6c 79 20 61 66 74 65 72 |mmediate|ly after|
|00002840| 20 74 68 65 20 64 61 74 | 61 20 70 6f 72 74 69 6f | the dat|a portio|
|00002850| 6e 20 6f 66 20 74 68 65 | 20 6f 62 6a 65 63 74 2e |n of the| object.|
|00002860| 20 20 54 68 65 20 73 69 | 7a 65 20 6f 66 20 74 68 |  The si|ze of th|
|00002870| 65 20 68 65 61 64 65 72 | 20 73 74 72 75 63 74 75 |e header| structu|
|00002880| 72 65 20 70 6c 75 73 0d | 74 68 65 20 76 61 6c 75 |re plus.|the valu|
|00002890| 65 20 69 6e 20 74 68 65 | 20 64 61 74 61 53 69 7a |e in the| dataSiz|
|000028a0| 65 20 66 69 65 6c 64 20 | 73 65 72 76 65 73 20 61 |e field |serves a|
|000028b0| 73 20 61 6e 20 6f 66 66 | 73 65 74 20 66 72 6f 6d |s an off|set from|
|000028c0| 20 74 68 65 20 62 65 67 | 69 6e 6e 69 6e 67 20 6f | the beg|inning o|
|000028d0| 66 20 74 68 65 20 6f 62 | 6a 65 63 74 20 74 6f 0d |f the ob|ject to.|
|000028e0| 74 68 65 20 63 68 69 6c | 64 20 68 61 6e 64 6c 65 |the chil|d handle|
|000028f0| 20 74 61 62 6c 65 2e 20 | 20 47 69 76 65 6e 20 74 | table. | Given t|
|00002900| 68 65 20 72 65 6c 61 74 | 69 6f 6e 73 68 69 70 20 |he relat|ionship |
|00002910| 62 65 74 77 65 65 6e 20 | 64 61 74 61 53 69 7a 65 |between |dataSize|
|00002920| 20 61 6e 64 20 74 68 65 | 20 63 68 69 6c 64 20 68 | and the| child h|
|00002930| 61 6e 64 6c 65 0d 74 61 | 62 6c 65 2c 20 69 74 20 |andle.ta|ble, it |
|00002940| 69 73 20 69 6d 70 6f 72 | 74 61 6e 74 20 74 68 61 |is impor|tant tha|
|00002950| 74 20 74 68 65 20 6f 62 | 6a 65 63 74 20 69 73 6e |t the ob|ject isn|
|00002960| 27 74 20 72 65 73 69 7a | 65 64 20 64 69 72 65 63 |'t resiz|ed direc|
|00002970| 74 6c 79 2e 20 20 54 68 | 65 72 65 20 61 72 65 20 |tly.  Th|ere are |
|00002980| 63 61 6c 6c 73 20 66 6f | 72 20 6d 61 6e 61 67 69 |calls fo|r managi|
|00002990| 6e 67 0d 74 68 65 20 64 | 61 74 61 20 61 72 65 61 |ng.the d|ata area|
|000029a0| 20 61 6e 64 20 69 74 73 | 20 73 69 7a 65 20 74 68 | and its| size th|
|000029b0| 61 74 20 74 61 6b 65 20 | 74 68 65 20 63 68 69 6c |at take |the chil|
|000029c0| 64 20 68 61 6e 64 6c 65 | 20 74 61 62 6c 65 20 69 |d handle| table i|
|000029d0| 6e 74 6f 20 61 63 63 6f | 75 6e 74 2e 20 20 54 68 |nto acco|unt.  Th|
|000029e0| 65 73 65 20 61 72 65 3a | 0d 0d 20 20 20 20 4f 53 |ese are:|..    OS|
|000029f0| 45 72 72 20 20 20 41 64 | 6a 75 73 74 44 61 74 61 |Err   Ad|justData|
|00002a00| 53 69 7a 65 28 54 72 65 | 65 4f 62 6a 48 6e 64 6c |Size(Tre|eObjHndl|
|00002a10| 20 68 6e 64 6c 2c 20 6c | 6f 6e 67 20 64 65 6c 74 | hndl, l|ong delt|
|00002a20| 61 29 3b 0d 20 20 20 20 | 4f 53 45 72 72 20 20 20 |a);.    |OSErr   |
|00002a30| 53 65 74 44 61 74 61 53 | 69 7a 65 28 54 72 65 65 |SetDataS|ize(Tree|
|00002a40| 4f 62 6a 48 6e 64 6c 20 | 68 6e 64 6c 2c 20 6c 6f |ObjHndl |hndl, lo|
|00002a50| 6e 67 20 6e 65 77 53 69 | 7a 65 29 3b 0d 20 20 20 |ng newSi|ze);.   |
|00002a60| 20 4f 53 45 72 72 20 20 | 20 53 6c 69 64 65 44 61 | OSErr  | SlideDa|
|00002a70| 74 61 28 54 72 65 65 4f | 62 6a 48 6e 64 6c 20 68 |ta(TreeO|bjHndl h|
|00002a80| 6e 64 6c 2c 20 6c 6f 6e | 67 20 6f 66 66 73 65 74 |ndl, lon|g offset|
|00002a90| 2c 20 6c 6f 6e 67 20 64 | 65 6c 74 61 29 3b 0d 20 |, long d|elta);. |
|00002aa0| 20 20 20 76 6f 69 64 20 | 20 20 20 2a 47 65 74 44 |   void |   *GetD|
|00002ab0| 61 74 61 50 74 72 28 54 | 72 65 65 4f 62 6a 48 6e |ataPtr(T|reeObjHn|
|00002ac0| 64 6c 20 68 6e 64 6c 29 | 3b 0d 0d 41 64 6a 75 73 |dl hndl)|;..Adjus|
|00002ad0| 74 44 61 74 61 53 69 7a | 65 20 61 6c 74 65 72 73 |tDataSiz|e alters|
|00002ae0| 20 74 68 65 20 73 69 7a | 65 20 6f 66 20 74 68 65 | the siz|e of the|
|00002af0| 20 64 61 74 61 20 61 72 | 65 61 2c 20 62 61 73 65 | data ar|ea, base|
|00002b00| 64 20 6f 6e 20 74 68 65 | 20 64 65 6c 74 61 20 70 |d on the| delta p|
|00002b10| 61 73 73 65 64 20 69 6e | 2e 20 20 49 66 20 79 6f |assed in|.  If yo|
|00002b20| 75 20 77 69 73 68 0d 74 | 6f 20 64 65 63 72 65 61 |u wish.t|o decrea|
|00002b30| 73 65 20 74 68 65 20 64 | 61 74 61 20 61 72 65 61 |se the d|ata area|
|00002b40| 20 62 79 20 6f 6e 65 20 | 62 79 74 65 2c 20 66 6f | by one |byte, fo|
|00002b50| 72 20 65 78 61 6d 70 6c | 65 2c 20 70 61 73 73 20 |r exampl|e, pass |
|00002b60| 69 6e 20 61 20 2d 31 2e | 20 20 41 64 6a 75 73 74 |in a -1.|  Adjust|
|00002b70| 44 61 74 61 53 69 7a 65 | 20 64 6f 65 73 20 6e 6f |DataSize| does no|
|00002b80| 74 0d 72 65 70 6f 73 69 | 74 69 6f 6e 20 61 6e 79 |t.reposi|tion any|
|00002b90| 20 6f 66 20 74 68 65 20 | 64 61 74 61 20 77 69 74 | of the |data wit|
|00002ba0| 68 69 6e 20 74 68 65 20 | 64 61 74 61 20 61 72 65 |hin the |data are|
|00002bb0| 61 2e 20 20 49 74 20 64 | 6f 65 73 20 6d 6f 76 65 |a.  It d|oes move|
|00002bc0| 20 74 68 65 20 63 68 69 | 6c 64 20 68 61 6e 64 6c | the chi|ld handl|
|00002bd0| 65 20 74 61 62 6c 65 20 | 73 6f 20 74 68 61 74 0d |e table |so that.|
|00002be0| 69 74 20 63 6f 6e 74 69 | 6e 75 65 73 20 74 6f 20 |it conti|nues to |
|00002bf0| 62 65 20 70 6f 73 69 74 | 69 6f 6e 65 64 20 69 6d |be posit|ioned im|
|00002c00| 6d 65 64 69 61 74 65 6c | 79 20 61 66 74 65 72 20 |mediatel|y after |
|00002c10| 74 68 65 20 64 61 74 61 | 20 61 72 65 61 2e 0d 0d |the data| area...|
|00002c20| 53 65 74 44 61 74 61 53 | 69 7a 65 20 64 6f 65 73 |SetDataS|ize does|
|00002c30| 20 61 73 20 65 78 70 65 | 63 74 65 64 2e 20 20 49 | as expe|cted.  I|
|00002c40| 74 20 73 70 65 63 69 66 | 69 63 61 6c 6c 79 20 73 |t specif|ically s|
|00002c50| 65 74 73 20 74 68 65 20 | 64 61 74 61 20 73 69 7a |ets the |data siz|
|00002c60| 65 20 74 6f 20 74 68 65 | 20 64 65 73 69 67 6e 61 |e to the| designa|
|00002c70| 74 65 64 0d 73 69 7a 65 | 2e 20 20 49 74 20 61 6c |ted.size|.  It al|
|00002c80| 73 6f 20 64 6f 65 73 20 | 6e 6f 74 20 73 68 69 66 |so does |not shif|
|00002c90| 74 20 74 68 65 20 64 61 | 74 61 2c 20 62 75 74 20 |t the da|ta, but |
|00002ca0| 64 6f 65 73 20 64 6f 20 | 74 68 65 20 61 70 70 72 |does do |the appr|
|00002cb0| 6f 70 72 69 61 74 65 20 | 63 68 69 6c 64 20 68 61 |opriate |child ha|
|00002cc0| 6e 64 6c 65 20 74 61 62 | 6c 65 0d 6d 61 69 6e 74 |ndle tab|le.maint|
|00002cd0| 65 6e 61 6e 63 65 2c 20 | 6a 75 73 74 20 61 73 20 |enance, |just as |
|00002ce0| 41 64 6a 75 73 74 44 61 | 74 61 53 69 7a 65 20 64 |AdjustDa|taSize d|
|00002cf0| 6f 65 73 2e 0d 0d 53 6c | 69 64 65 44 61 74 61 20 |oes...Sl|ideData |
|00002d00| 6f 70 65 72 61 74 65 73 | 20 74 68 65 20 73 61 6d |operates| the sam|
|00002d10| 65 20 61 73 20 41 64 6a | 75 73 74 44 61 74 61 53 |e as Adj|ustDataS|
|00002d20| 69 7a 65 2c 20 70 6c 75 | 73 20 69 74 20 61 6c 73 |ize, plu|s it als|
|00002d30| 6f 20 73 6c 69 64 65 73 | 20 73 6f 6d 65 20 6f 72 |o slides| some or|
|00002d40| 20 61 6c 6c 20 6f 66 20 | 74 68 65 0d 64 61 74 61 | all of |the.data|
|00002d50| 20 69 6e 20 74 68 65 20 | 64 61 74 61 20 61 72 65 | in the |data are|
|00002d60| 61 2e 20 20 55 73 65 20 | 53 6c 69 64 65 44 61 74 |a.  Use |SlideDat|
|00002d70| 61 20 74 6f 20 69 6e 73 | 65 72 74 20 6f 72 20 72 |a to ins|ert or r|
|00002d80| 65 6d 6f 76 65 20 64 61 | 74 61 20 61 74 20 73 6f |emove da|ta at so|
|00002d90| 6d 65 20 6c 6f 63 61 74 | 69 6f 6e 20 77 69 74 68 |me locat|ion with|
|00002da0| 69 6e 0d 74 68 65 20 64 | 61 74 61 20 61 72 65 61 |in.the d|ata area|
|00002db0| 2e 0d 0d 47 65 74 44 61 | 74 61 50 74 72 20 73 69 |...GetDa|taPtr si|
|00002dc0| 6d 70 6c 79 20 72 65 74 | 75 72 6e 73 20 61 20 70 |mply ret|urns a p|
|00002dd0| 6f 69 6e 74 65 72 20 74 | 6f 20 74 68 65 20 62 65 |ointer t|o the be|
|00002de0| 67 69 6e 6e 69 6e 67 20 | 6f 66 20 74 68 65 20 64 |ginning |of the d|
|00002df0| 61 74 61 20 61 72 65 61 | 2e 20 20 49 54 20 44 4f |ata area|.  IT DO|
|00002e00| 45 53 20 4e 4f 54 20 4c | 4f 43 4b 0d 54 48 45 20 |ES NOT L|OCK.THE |
|00002e10| 48 41 4e 44 4c 45 21 21 | 20 20 49 66 20 74 68 65 |HANDLE!!|  If the|
|00002e20| 20 68 61 6e 64 6c 65 20 | 6e 65 65 64 73 20 6c 6f | handle |needs lo|
|00002e30| 63 6b 69 6e 67 2c 20 74 | 68 65 6e 20 79 6f 75 20 |cking, t|hen you |
|00002e40| 6d 75 73 74 20 64 6f 20 | 74 68 69 73 20 79 6f 75 |must do |this you|
|00002e50| 72 73 65 6c 66 2e 20 20 | 53 69 6e 63 65 20 74 68 |rself.  |Since th|
|00002e60| 65 20 6f 62 6a 65 63 74 | 0d 69 73 20 73 69 6d 70 |e object|.is simp|
|00002e70| 6c 79 20 61 20 68 61 6e | 64 6c 65 2c 20 74 68 69 |ly a han|dle, thi|
|00002e80| 73 20 70 6f 73 65 73 20 | 6e 6f 20 64 69 66 66 69 |s poses |no diffi|
|00002e90| 63 75 6c 74 69 65 73 2e | 20 20 28 55 6e 6c 6f 63 |culties.|  (Unloc|
|00002ea0| 6b 20 77 68 65 6e 20 79 | 6f 75 20 61 72 65 20 64 |k when y|ou are d|
|00002eb0| 6f 6e 65 2c 20 6f 66 20 | 63 6f 75 72 73 65 2e 29 |one, of |course.)|
|00002ec0| 0d 0d 0d 54 68 65 20 63 | 68 69 6c 64 20 68 61 6e |...The c|hild han|
|00002ed0| 64 6c 65 20 74 61 62 6c | 65 20 69 73 20 61 75 74 |dle tabl|e is aut|
|00002ee0| 6f 6d 61 74 69 63 61 6c | 6c 79 20 68 61 6e 64 6c |omatical|ly handl|
|00002ef0| 65 64 2e 20 20 54 68 65 | 72 65 20 73 68 6f 75 6c |ed.  The|re shoul|
|00002f00| 64 6e 27 74 20 62 65 20 | 61 20 72 65 61 73 6f 6e |dn't be |a reason|
|00002f10| 20 74 68 61 74 20 79 6f | 75 20 6e 65 65 64 0d 74 | that yo|u need.t|
|00002f20| 6f 20 6d 61 6e 61 67 65 | 20 6f 72 20 72 65 66 65 |o manage| or refe|
|00002f30| 72 65 6e 63 65 20 74 68 | 69 73 20 79 6f 75 72 73 |rence th|is yours|
|00002f40| 65 6c 66 2e 20 20 49 66 | 20 68 6f 77 65 76 65 72 |elf.  If| however|
|00002f50| 20 79 6f 75 20 65 6e 64 | 20 75 70 20 6e 65 65 64 | you end| up need|
|00002f60| 69 6e 67 20 74 6f 20 64 | 6f 20 74 68 69 73 2c 20 |ing to d|o this, |
|00002f70| 74 68 65 72 65 0d 61 72 | 65 20 63 61 6c 6c 73 20 |there.ar|e calls |
|00002f80| 74 6f 20 6d 61 6e 61 67 | 65 20 74 68 65 20 63 68 |to manag|e the ch|
|00002f90| 69 6c 64 20 68 61 6e 64 | 6c 65 20 74 61 62 6c 65 |ild hand|le table|
|00002fa0| 2e 0d 0d 0d 4f 62 6a 65 | 63 74 73 20 72 65 66 65 |....Obje|cts refe|
|00002fb0| 72 65 6e 63 69 6e 67 20 | 6f 74 68 65 72 20 6f 62 |rencing |other ob|
|00002fc0| 6a 65 63 74 73 3a 0d 0d | 4c 65 74 27 73 20 72 65 |jects:..|Let's re|
|00002fd0| 76 69 73 69 74 20 74 68 | 65 20 77 6f 72 64 2d 70 |visit th|e word-p|
|00002fe0| 72 6f 63 65 73 73 6f 72 | 20 65 78 61 6d 70 6c 65 |rocessor| example|
|00002ff0| 2e 20 20 4f 6e 63 65 20 | 61 67 61 69 6e 2c 20 77 |.  Once |again, w|
|00003000| 65 20 68 61 76 65 20 74 | 68 69 73 20 70 61 72 61 |e have t|his para|
|00003010| 67 72 61 70 68 2d 62 61 | 73 65 64 20 77 6f 72 64 |graph-ba|sed word|
|00003020| 0d 70 72 6f 63 65 73 73 | 6f 72 2e 20 20 54 68 65 |.process|or.  The|
|00003030| 20 75 73 65 72 20 73 65 | 6c 65 63 74 73 20 73 6f | user se|lects so|
|00003040| 6d 65 20 74 65 78 74 2e | 20 20 54 68 65 20 63 75 |me text.|  The cu|
|00003050| 72 73 6f 72 20 6c 6f 63 | 61 74 69 6f 6e 20 28 69 |rsor loc|ation (i|
|00003060| 6e 73 65 72 74 69 6f 6e | 20 70 6f 69 6e 74 29 20 |nsertion| point) |
|00003070| 6d 75 73 74 20 62 65 20 | 6b 65 70 74 2e 0d 41 20 |must be |kept..A |
|00003080| 72 65 66 65 72 65 6e 63 | 65 20 74 6f 20 74 68 65 |referenc|e to the|
|00003090| 20 73 74 61 72 74 69 6e | 67 20 6f 62 6a 65 63 74 | startin|g object|
|000030a0| 20 61 6e 64 20 61 6e 20 | 6f 66 66 73 65 74 20 69 | and an |offset i|
|000030b0| 6e 74 6f 20 74 68 65 20 | 64 61 74 61 20 6f 66 20 |nto the |data of |
|000030c0| 74 68 61 74 20 6f 62 6a | 65 63 74 20 77 6f 75 6c |that obj|ect woul|
|000030d0| 64 20 73 65 72 76 65 20 | 61 73 0d 74 68 65 20 63 |d serve |as.the c|
|000030e0| 75 72 73 6f 72 20 6c 6f | 63 61 74 69 6f 6e 20 72 |ursor lo|cation r|
|000030f0| 65 66 65 72 65 6e 63 65 | 2e 0d 0d 54 68 69 73 20 |eference|...This |
|00003100| 72 65 66 65 72 65 6e 63 | 65 20 74 6f 20 74 68 65 |referenc|e to the|
|00003110| 20 70 61 72 61 67 72 61 | 70 68 20 6f 62 6a 65 63 | paragra|ph objec|
|00003120| 74 20 63 6f 6e 74 61 69 | 6e 69 6e 67 20 74 68 65 |t contai|ning the|
|00003130| 20 69 6e 73 65 72 74 69 | 6f 6e 20 70 6f 69 6e 74 | inserti|on point|
|00003140| 20 63 6f 75 6c 64 20 62 | 65 20 6b 65 70 74 20 61 | could b|e kept a|
|00003150| 73 20 65 69 74 68 65 72 | 0d 61 20 68 61 6e 64 6c |s either|.a handl|
|00003160| 65 20 72 65 66 65 72 65 | 6e 63 65 20 6f 72 20 61 |e refere|nce or a|
|00003170| 20 63 68 69 6c 64 20 6e | 75 6d 62 65 72 20 72 65 | child n|umber re|
|00003180| 66 65 72 65 6e 63 65 2e | 20 20 45 69 74 68 65 72 |ference.|  Either|
|00003190| 20 77 6f 75 6c 64 20 73 | 65 72 76 65 20 74 68 65 | would s|erve the|
|000031a0| 20 70 75 72 70 6f 73 65 | 2e 20 20 42 6f 74 68 20 | purpose|.  Both |
|000031b0| 77 6f 75 6c 64 0d 75 6e | 69 71 75 65 6c 79 20 64 |would.un|iquely d|
|000031c0| 65 73 63 72 69 62 65 20 | 61 6e 20 6f 62 6a 65 63 |escribe |an objec|
|000031d0| 74 20 69 6e 20 74 68 65 | 20 64 6f 63 75 6d 65 6e |t in the| documen|
|000031e0| 74 2e 20 20 54 68 65 20 | 68 61 6e 64 6c 65 20 72 |t.  The |handle r|
|000031f0| 65 66 65 72 65 6e 63 65 | 20 77 6f 75 6c 64 20 64 |eference| would d|
|00003200| 69 72 65 63 74 6c 79 20 | 72 65 66 65 72 65 6e 63 |irectly |referenc|
|00003210| 65 0d 74 68 65 20 6f 62 | 6a 65 63 74 2e 20 20 54 |e.the ob|ject.  T|
|00003220| 68 65 20 63 68 69 6c 64 | 20 6e 75 6d 62 65 72 20 |he child| number |
|00003230| 72 65 66 65 72 65 6e 63 | 65 20 77 6f 75 6c 64 20 |referenc|e would |
|00003240| 69 6e 64 69 72 65 63 74 | 6c 79 20 72 65 66 65 72 |indirect|ly refer|
|00003250| 65 6e 63 65 20 74 68 65 | 20 6f 62 6a 65 63 74 2e |ence the| object.|
|00003260| 20 20 49 66 20 77 65 20 | 75 73 65 64 0d 63 68 69 |  If we |used.chi|
|00003270| 6c 64 20 6e 75 6d 62 65 | 72 73 20 61 73 20 6f 75 |ld numbe|rs as ou|
|00003280| 72 20 72 65 66 65 72 65 | 6e 63 65 20 61 6e 64 20 |r refere|nce and |
|00003290| 77 65 20 64 65 73 69 72 | 65 64 20 74 6f 20 67 65 |we desir|ed to ge|
|000032a0| 74 20 74 68 65 20 68 61 | 6e 64 6c 65 20 6f 66 20 |t the ha|ndle of |
|000032b0| 74 68 65 20 6f 62 6a 65 | 63 74 2c 20 77 65 20 77 |the obje|ct, we w|
|000032c0| 6f 75 6c 64 20 64 6f 0d | 73 6f 6d 65 74 68 69 6e |ould do.|somethin|
|000032d0| 67 20 6c 69 6b 65 20 74 | 68 65 20 66 6f 6c 6c 6f |g like t|he follo|
|000032e0| 77 69 6e 67 3a 0d 0d 20 | 20 20 20 63 68 6e 64 6c |wing:.. |   chndl|
|000032f0| 20 3d 20 47 65 74 43 68 | 69 6c 64 48 6e 64 6c 28 | = GetCh|ildHndl(|
|00003300| 72 6f 6f 74 2c 20 63 6e | 75 6d 29 3b 0d 0d 49 6e |root, cn|um);..In|
|00003310| 20 6f 75 72 20 64 6f 63 | 75 6d 65 6e 74 20 65 78 | our doc|ument ex|
|00003320| 61 6d 70 6c 65 2c 20 61 | 6c 6c 20 6f 66 20 74 68 |ample, a|ll of th|
|00003330| 65 20 70 61 72 61 67 72 | 61 70 68 20 6f 62 6a 65 |e paragr|aph obje|
|00003340| 63 74 73 20 61 72 65 20 | 63 68 69 6c 64 72 65 6e |cts are |children|
|00003350| 20 6f 66 20 74 68 65 20 | 72 6f 6f 74 20 6f 62 6a | of the |root obj|
|00003360| 65 63 74 2e 0d 49 6e 20 | 74 68 69 73 20 63 61 73 |ect..In |this cas|
|00003370| 65 20 69 74 20 77 6f 75 | 6c 64 20 62 65 20 61 20 |e it wou|ld be a |
|00003380| 73 69 6d 70 6c 65 20 6d | 61 74 74 65 72 20 6f 66 |simple m|atter of|
|00003390| 20 67 65 74 74 69 6e 67 | 20 74 68 65 20 63 68 69 | getting| the chi|
|000033a0| 6c 64 20 68 61 6e 64 6c | 65 2e 20 20 54 68 65 20 |ld handl|e.  The |
|000033b0| 63 68 69 6c 64 20 6e 75 | 6d 62 65 72 0d 72 65 66 |child nu|mber.ref|
|000033c0| 65 72 65 6e 63 65 20 77 | 6f 75 6c 64 20 70 72 6f |erence w|ould pro|
|000033d0| 62 61 62 6c 79 20 62 65 | 20 73 74 6f 72 65 64 20 |bably be| stored |
|000033e0| 69 6e 20 74 68 65 20 72 | 6f 6f 74 20 6f 62 6a 65 |in the r|oot obje|
|000033f0| 63 74 2c 20 61 73 20 69 | 74 20 69 73 20 61 20 67 |ct, as i|t is a g|
|00003400| 6c 6f 62 61 6c 20 70 69 | 65 63 65 20 6f 66 20 69 |lobal pi|ece of i|
|00003410| 6e 66 6f 72 6d 61 74 69 | 6f 6e 0d 66 6f 72 20 74 |nformati|on.for t|
|00003420| 68 69 73 20 64 6f 63 75 | 6d 65 6e 74 2e 20 20 57 |his docu|ment.  W|
|00003430| 65 20 77 6f 75 6c 64 20 | 70 72 6f 62 61 62 6c 79 |e would |probably|
|00003440| 20 77 61 6e 74 20 69 74 | 20 73 61 76 65 64 20 77 | want it| saved w|
|00003450| 69 74 68 20 74 68 65 20 | 64 6f 63 75 6d 65 6e 74 |ith the |document|
|00003460| 2c 20 77 68 69 63 68 20 | 77 6f 75 6c 64 20 6f 63 |, which |would oc|
|00003470| 63 75 72 0d 61 75 74 6f | 6d 61 74 69 63 61 6c 6c |cur.auto|maticall|
|00003480| 79 20 69 66 20 69 74 20 | 77 65 72 65 20 73 74 6f |y if it |were sto|
|00003490| 72 65 64 20 69 6e 20 74 | 68 65 20 72 6f 6f 74 20 |red in t|he root |
|000034a0| 6f 62 6a 65 63 74 2e 0d | 0d 53 6f 2c 20 73 69 6e |object..|.So, sin|
|000034b0| 63 65 20 74 68 65 79 20 | 62 6f 74 68 20 73 65 65 |ce they |both see|
|000034c0| 6d 20 74 6f 20 77 6f 72 | 6b 2c 20 77 68 69 63 68 |m to wor|k, which|
|000034d0| 20 69 73 20 62 65 74 74 | 65 72 3f 20 20 49 73 20 | is bett|er?  Is |
|000034e0| 6b 65 65 70 69 6e 67 20 | 74 68 65 20 68 61 6e 64 |keeping |the hand|
|000034f0| 6c 65 20 62 65 74 74 65 | 72 2c 20 6f 72 20 69 73 |le bette|r, or is|
|00003500| 20 6b 65 65 70 69 6e 67 | 0d 74 68 65 20 63 68 69 | keeping|.the chi|
|00003510| 6c 64 20 6e 75 6d 62 65 | 72 20 62 65 74 74 65 72 |ld numbe|r better|
|00003520| 3f 20 20 57 68 65 6e 20 | 73 61 76 69 6e 67 20 61 |?  When |saving a|
|00003530| 20 64 6f 63 75 6d 65 6e | 74 2c 20 63 68 69 6c 64 | documen|t, child|
|00003540| 20 6e 75 6d 62 65 72 73 | 20 77 69 6c 6c 20 62 65 | numbers| will be|
|00003550| 20 6d 65 61 6e 69 6e 67 | 66 75 6c 20 77 68 65 6e | meaning|ful when|
|00003560| 20 74 68 65 0d 64 6f 63 | 75 6d 65 6e 74 20 69 73 | the.doc|ument is|
|00003570| 20 6f 70 65 6e 65 64 20 | 61 74 20 61 20 66 75 74 | opened |at a fut|
|00003580| 75 72 65 20 64 61 74 65 | 2e 20 20 52 65 66 65 72 |ure date|.  Refer|
|00003590| 65 6e 63 65 73 20 74 6f | 20 68 61 6e 64 6c 65 73 |ences to| handles|
|000035a0| 20 61 72 65 6e 27 74 20 | 6d 65 61 6e 69 6e 67 66 | aren't |meaningf|
|000035b0| 75 6c 20 77 68 65 6e 20 | 73 61 76 65 64 20 74 6f |ul when |saved to|
|000035c0| 20 64 69 73 6b 0d 61 6e | 64 20 74 68 65 6e 20 72 | disk.an|d then r|
|000035d0| 65 6c 6f 61 64 65 64 2e | 20 20 46 6f 72 20 74 68 |eloaded.|  For th|
|000035e0| 69 73 20 72 65 61 73 6f | 6e 20 69 74 20 73 65 65 |is reaso|n it see|
|000035f0| 6d 73 20 74 68 61 74 20 | 63 68 69 6c 64 20 6e 75 |ms that |child nu|
|00003600| 6d 62 65 72 20 73 68 6f | 75 6c 64 20 77 69 6e 20 |mber sho|uld win |
|00003610| 6f 75 74 2e 0d 0d 42 75 | 74 20 77 68 61 74 20 69 |out...Bu|t what i|
|00003620| 66 20 79 6f 75 20 77 69 | 73 68 20 74 6f 20 6b 65 |f you wi|sh to ke|
|00003630| 65 70 20 61 20 72 65 66 | 65 72 65 6e 63 65 20 74 |ep a ref|erence t|
|00003640| 6f 20 73 6f 6d 65 20 61 | 72 62 69 74 72 61 72 79 |o some a|rbitrary|
|00003650| 20 70 6f 69 6e 74 20 69 | 6e 20 74 68 65 20 64 6f | point i|n the do|
|00003660| 63 75 6d 65 6e 74 3f 20 | 20 57 68 61 74 20 69 66 |cument? | What if|
|00003670| 20 79 6f 75 0d 64 6f 6e | 27 74 20 6b 6e 6f 77 20 | you.don|'t know |
|00003680| 77 68 61 74 20 74 68 65 | 20 70 61 72 65 6e 74 20 |what the| parent |
|00003690| 6f 66 20 74 68 61 74 20 | 6f 62 6a 65 63 74 20 69 |of that |object i|
|000036a0| 73 3f 20 20 57 68 61 74 | 20 69 66 20 74 68 65 20 |s?  What| if the |
|000036b0| 6f 62 6a 65 63 74 20 69 | 73 20 61 74 20 73 6f 6d |object i|s at som|
|000036c0| 65 20 61 72 62 69 74 72 | 61 72 79 20 64 65 70 74 |e arbitr|ary dept|
|000036d0| 68 0d 69 6e 20 74 68 65 | 20 68 69 65 72 61 72 63 |h.in the| hierarc|
|000036e0| 68 79 3f 20 20 49 6e 20 | 74 68 69 73 20 63 61 73 |hy?  In |this cas|
|000036f0| 65 2c 20 69 74 20 73 65 | 65 6d 73 20 70 72 65 74 |e, it se|ems pret|
|00003700| 74 79 20 63 6c 65 61 72 | 20 74 68 61 74 20 77 65 |ty clear| that we|
|00003710| 20 77 69 73 68 20 74 6f | 20 75 73 65 20 68 61 6e | wish to| use han|
|00003720| 64 6c 65 20 72 65 66 65 | 72 65 6e 63 65 73 0d 69 |dle refe|rences.i|
|00003730| 6e 73 74 65 61 64 20 6f | 66 20 63 68 69 6c 64 20 |nstead o|f child |
|00003740| 6e 75 6d 62 65 72 20 72 | 65 66 65 72 65 6e 63 65 |number r|eference|
|00003750| 73 2c 20 61 74 20 6c 65 | 61 73 74 20 77 68 65 6e |s, at le|ast when|
|00003760| 20 74 68 65 20 64 6f 63 | 75 6d 65 6e 74 20 69 73 | the doc|ument is|
|00003770| 20 69 6e 20 6d 65 6d 6f | 72 79 2e 0d 0d 53 6f 20 | in memo|ry...So |
|00003780| 77 68 61 74 20 61 62 6f | 75 74 20 68 61 6e 64 6c |what abo|ut handl|
|00003790| 65 20 72 65 66 65 72 65 | 6e 63 65 73 20 77 68 65 |e refere|nces whe|
|000037a0| 6e 20 73 61 76 65 64 20 | 74 6f 20 64 69 73 6b 3f |n saved |to disk?|
|000037b0| 20 20 57 65 20 6e 65 65 | 64 20 74 68 65 73 65 20 |  We nee|d these |
|000037c0| 72 65 66 65 72 65 6e 63 | 65 73 20 74 6f 20 70 65 |referenc|es to pe|
|000037d0| 72 73 69 73 74 2e 20 20 | 54 6f 0d 64 6f 20 74 68 |rsist.  |To.do th|
|000037e0| 69 73 2c 20 77 65 20 6d | 75 73 74 20 63 6f 6e 76 |is, we m|ust conv|
|000037f0| 65 72 74 20 74 68 65 6d | 20 74 6f 20 73 6f 6d 65 |ert them| to some|
|00003800| 74 68 69 6e 67 20 74 68 | 61 74 20 73 61 76 65 73 |thing th|at saves|
|00003810| 20 6d 65 61 6e 69 6e 67 | 66 75 6c 6c 79 20 61 6e | meaning|fully an|
|00003820| 64 20 63 61 6e 20 62 65 | 20 63 6f 6e 76 65 72 74 |d can be| convert|
|00003830| 65 64 20 62 61 63 6b 0d | 74 6f 20 68 61 6e 64 6c |ed back.|to handl|
|00003840| 65 20 72 65 66 65 72 65 | 6e 63 65 73 20 77 68 65 |e refere|nces whe|
|00003850| 6e 20 74 68 65 20 64 6f | 63 75 6d 65 6e 74 20 69 |n the do|cument i|
|00003860| 73 20 72 65 6f 70 65 6e | 65 64 2e 0d 0d 54 68 69 |s reopen|ed...Thi|
|00003870| 73 20 69 73 20 77 68 61 | 74 20 74 68 65 20 74 72 |s is wha|t the tr|
|00003880| 65 65 49 44 20 66 69 65 | 6c 64 20 69 6e 20 74 68 |eeID fie|ld in th|
|00003890| 65 20 6f 62 6a 65 63 74 | 20 68 65 61 64 65 72 20 |e object| header |
|000038a0| 69 73 20 66 6f 72 2e 20 | 20 57 68 65 6e 20 44 6f |is for. | When Do|
|000038b0| 4e 75 6d 62 65 72 54 72 | 65 65 20 69 73 20 63 61 |NumberTr|ee is ca|
|000038c0| 6c 6c 65 64 2c 0d 61 6c | 6c 20 6f 66 20 74 68 65 |lled,.al|l of the|
|000038d0| 20 6f 62 6a 65 63 74 73 | 20 69 6e 20 74 68 65 20 | objects| in the |
|000038e0| 68 69 65 72 61 72 63 68 | 79 20 61 72 65 20 75 6e |hierarch|y are un|
|000038f0| 69 71 75 65 6c 79 20 6e | 75 6d 62 65 72 65 64 2e |iquely n|umbered.|
|00003900| 20 20 44 6f 4e 75 6d 62 | 65 72 54 72 65 65 20 69 |  DoNumb|erTree i|
|00003910| 73 20 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 0d |s automa|tically.|
|00003920| 63 61 6c 6c 65 64 20 62 | 79 20 74 68 65 20 73 68 |called b|y the sh|
|00003930| 65 6c 6c 20 6a 75 73 74 | 20 70 72 69 6f 72 20 74 |ell just| prior t|
|00003940| 6f 20 74 68 65 20 6f 62 | 6a 65 63 74 73 20 69 6e |o the ob|jects in|
|00003950| 20 61 20 68 69 65 72 61 | 72 63 68 79 20 61 72 65 | a hiera|rchy are|
|00003960| 20 77 72 69 74 74 65 6e | 20 74 6f 20 64 69 73 6b | written| to disk|
|00003970| 2e 20 20 49 6e 0d 61 64 | 64 69 74 69 6f 6e 2c 20 |.  In.ad|dition, |
|00003980| 70 72 69 6f 72 20 74 6f | 20 77 72 69 74 69 6e 67 |prior to| writing|
|00003990| 20 61 6e 20 6f 62 6a 65 | 63 74 20 6f 75 74 20 74 | an obje|ct out t|
|000039a0| 6f 20 64 69 73 6b 2c 20 | 74 68 65 20 6f 62 6a 65 |o disk, |the obje|
|000039b0| 63 74 20 69 73 20 63 61 | 6c 6c 65 64 20 77 69 74 |ct is ca|lled wit|
|000039c0| 68 20 61 20 6d 65 73 73 | 61 67 65 0d 72 65 71 75 |h a mess|age.requ|
|000039d0| 65 73 74 69 6e 67 20 69 | 74 20 74 6f 20 63 6f 6e |esting i|t to con|
|000039e0| 76 65 72 74 20 61 6e 79 | 20 68 61 6e 64 6c 65 20 |vert any| handle |
|000039f0| 72 65 66 65 72 65 6e 63 | 65 73 20 69 74 20 63 6f |referenc|es it co|
|00003a00| 6e 74 61 69 6e 73 20 74 | 6f 20 74 72 65 65 49 44 |ntains t|o treeID|
|00003a10| 20 72 65 66 65 72 65 6e | 63 65 73 2e 20 20 46 6f | referen|ces.  Fo|
|00003a20| 72 20 65 61 63 68 0d 68 | 61 6e 64 6c 65 20 72 65 |r each.h|andle re|
|00003a30| 66 65 72 65 6e 63 65 20 | 74 68 61 74 20 6e 65 65 |ference |that nee|
|00003a40| 64 73 20 74 6f 20 62 65 | 20 63 6f 6e 76 65 72 74 |ds to be| convert|
|00003a50| 65 64 2c 20 79 6f 75 20 | 6e 65 65 64 20 74 6f 20 |ed, you |need to |
|00003a60| 63 61 6c 6c 20 48 6e 64 | 6c 32 49 44 20 74 6f 20 |call Hnd|l2ID to |
|00003a70| 64 6f 20 74 68 65 20 63 | 6f 6e 76 65 72 73 69 6f |do the c|onversio|
|00003a80| 6e 2e 0d 48 6e 64 6c 32 | 49 44 20 64 65 70 65 6e |n..Hndl2|ID depen|
|00003a90| 64 73 20 6f 6e 20 44 6f | 4e 75 6d 62 65 72 54 72 |ds on Do|NumberTr|
|00003aa0| 65 65 20 61 6c 72 65 61 | 64 79 20 62 65 69 6e 67 |ee alrea|dy being|
|00003ab0| 20 63 61 6c 6c 65 64 20 | 73 6f 20 74 68 61 74 20 | called |so that |
|00003ac0| 61 6c 6c 20 6f 66 20 74 | 68 65 20 74 72 65 65 49 |all of t|he treeI|
|00003ad0| 44 20 66 69 65 6c 64 73 | 0d 66 6f 72 20 61 6c 6c |D fields|.for all|
|00003ae0| 20 6f 66 20 74 68 65 20 | 6f 62 6a 65 63 74 73 20 | of the |objects |
|00003af0| 69 6e 20 74 68 65 20 68 | 69 65 72 61 72 63 68 79 |in the h|ierarchy|
|00003b00| 20 61 72 65 20 63 75 72 | 72 65 6e 74 2e 0d 0d 41 | are cur|rent...A|
|00003b10| 66 74 65 72 20 63 61 6c | 6c 69 6e 67 20 74 68 65 |fter cal|ling the|
|00003b20| 20 6f 62 6a 65 63 74 20 | 77 69 74 68 20 74 68 65 | object |with the|
|00003b30| 20 68 61 6e 64 6c 65 2d | 74 6f 2d 69 64 20 63 6f | handle-|to-id co|
|00003b40| 6e 76 65 72 73 69 6f 6e | 20 6d 65 73 73 61 67 65 |nversion| message|
|00003b50| 2c 20 74 68 65 20 6f 62 | 6a 65 63 74 20 69 73 20 |, the ob|ject is |
|00003b60| 77 72 69 74 74 65 6e 0d | 74 6f 20 64 69 73 6b 2e |written.|to disk.|
|00003b70| 20 20 4f 6e 63 65 20 69 | 74 20 69 73 20 77 72 69 |  Once i|t is wri|
|00003b80| 74 74 65 6e 2c 20 61 20 | 6d 65 73 73 61 67 65 20 |tten, a |message |
|00003b90| 69 73 20 73 65 6e 74 20 | 74 6f 20 74 68 65 20 6f |is sent |to the o|
|00003ba0| 62 6a 65 63 74 20 72 65 | 71 75 65 73 74 69 6e 67 |bject re|questing|
|00003bb0| 20 69 74 20 74 6f 20 63 | 6f 76 65 72 74 20 74 68 | it to c|overt th|
|00003bc0| 65 0d 69 64 20 62 61 63 | 6b 20 69 6e 74 6f 20 61 |e.id bac|k into a|
|00003bd0| 20 68 61 6e 64 6c 65 20 | 72 65 66 65 72 65 6e 63 | handle |referenc|
|00003be0| 65 2e 20 20 46 6f 72 20 | 65 61 63 68 20 72 65 66 |e.  For |each ref|
|00003bf0| 65 72 65 6e 63 65 20 63 | 6f 6e 76 65 72 74 65 64 |erence c|onverted|
|00003c00| 2c 20 79 6f 75 20 6e 65 | 65 64 20 74 6f 20 63 61 |, you ne|ed to ca|
|00003c10| 6c 6c 20 49 44 32 48 6e | 64 6c 0d 74 6f 20 64 65 |ll ID2Hn|dl.to de|
|00003c20| 63 6f 6e 76 65 72 74 20 | 74 68 65 20 72 65 66 65 |convert |the refe|
|00003c30| 72 65 6e 63 65 20 62 61 | 63 6b 20 69 6e 74 6f 20 |rence ba|ck into |
|00003c40| 61 20 68 61 6e 64 6c 65 | 2e 0d 0d 57 68 65 6e 20 |a handle|...When |
|00003c50| 61 20 64 6f 63 75 6d 65 | 6e 74 20 69 73 20 6f 70 |a docume|nt is op|
|00003c60| 65 6e 65 64 2c 20 61 6c | 6c 20 6f 66 20 74 68 65 |ened, al|l of the|
|00003c70| 20 6f 62 6a 65 63 74 73 | 20 61 72 65 20 66 69 72 | objects| are fir|
|00003c80| 73 74 20 72 65 61 64 20 | 69 6e 74 6f 20 6d 65 6d |st read |into mem|
|00003c90| 6f 72 79 2e 20 20 4f 6e | 63 65 20 74 68 65 20 65 |ory.  On|ce the e|
|00003ca0| 6e 74 69 72 65 0d 64 6f | 63 75 6d 65 6e 74 20 69 |ntire.do|cument i|
|00003cb0| 73 20 69 6e 20 6d 65 6d | 6f 72 79 2c 20 44 6f 4e |s in mem|ory, DoN|
|00003cc0| 75 6d 62 65 72 54 72 65 | 65 20 69 73 20 63 61 6c |umberTre|e is cal|
|00003cd0| 6c 65 64 2c 20 61 6e 64 | 20 74 68 65 6e 20 65 61 |led, and| then ea|
|00003ce0| 63 68 20 6f 62 6a 65 63 | 74 20 69 6e 20 74 68 65 |ch objec|t in the|
|00003cf0| 20 64 6f 63 75 6d 65 6e | 74 20 69 73 0d 73 65 6e | documen|t is.sen|
|00003d00| 74 20 61 20 6d 65 73 73 | 61 67 65 20 72 65 71 75 |t a mess|age requ|
|00003d10| 65 73 74 69 6e 67 20 69 | 74 20 74 6f 20 63 6f 6e |esting i|t to con|
|00003d20| 76 65 72 74 20 74 68 65 | 20 63 6f 6e 76 65 72 74 |vert the| convert|
|00003d30| 65 64 20 68 61 6e 64 6c | 65 20 72 65 66 65 72 65 |ed handl|e refere|
|00003d40| 6e 63 65 73 20 62 61 63 | 6b 20 69 6e 74 6f 20 72 |nces bac|k into r|
|00003d50| 65 61 6c 0d 68 61 6e 64 | 6c 65 20 72 65 66 65 72 |eal.hand|le refer|
|00003d60| 65 6e 63 65 73 2e 0d 0d | 54 68 65 20 72 65 61 73 |ences...|The reas|
|00003d70| 6f 6e 20 74 68 61 74 20 | 74 68 65 20 65 6e 74 69 |on that |the enti|
|00003d80| 72 65 20 64 6f 63 75 6d | 65 6e 74 20 6d 75 73 74 |re docum|ent must|
|00003d90| 20 66 69 72 73 74 20 62 | 65 20 72 65 61 64 20 69 | first b|e read i|
|00003da0| 73 20 74 68 61 74 20 74 | 68 65 20 72 65 66 65 72 |s that t|he refer|
|00003db0| 65 6e 63 65 20 74 6f 20 | 61 6e 6f 74 68 65 72 20 |ence to |another |
|00003dc0| 6f 62 6a 65 63 74 0d 6d | 61 79 20 62 65 20 74 6f |object.m|ay be to|
|00003dd0| 20 61 6e 20 6f 62 6a 65 | 63 74 20 74 68 61 74 20 | an obje|ct that |
|00003de0| 69 73 20 6c 61 74 65 72 | 20 69 6e 20 74 68 65 20 |is later| in the |
|00003df0| 64 6f 63 75 6d 65 6e 74 | 2e 20 20 4f 6e 6c 79 20 |document|.  Only |
|00003e00| 61 66 74 65 72 20 74 68 | 65 20 65 6e 74 69 72 65 |after th|e entire|
|00003e10| 20 64 6f 63 75 6d 65 6e | 74 20 69 73 20 72 65 61 | documen|t is rea|
|00003e20| 64 20 69 6e 0d 69 73 20 | 69 74 20 70 6f 73 73 69 |d in.is |it possi|
|00003e30| 62 6c 65 20 74 6f 20 72 | 65 73 6f 6c 76 65 20 61 |ble to r|esolve a|
|00003e40| 6c 6c 20 72 65 66 65 72 | 65 6e 63 65 73 20 74 6f |ll refer|ences to|
|00003e50| 20 61 6e 79 77 68 65 72 | 65 20 69 6e 20 74 68 65 | anywher|e in the|
|00003e60| 20 64 6f 63 75 6d 65 6e | 74 2e 0d 0d 54 68 69 73 | documen|t...This|
|00003e70| 20 6d 65 73 73 61 67 69 | 6e 67 20 6d 65 63 68 61 | messagi|ng mecha|
|00003e80| 6e 69 73 6d 20 61 6c 6c | 6f 77 73 20 79 6f 75 20 |nism all|ows you |
|00003e90| 74 6f 20 75 73 65 20 68 | 61 6e 64 6c 65 20 72 65 |to use h|andle re|
|00003ea0| 66 65 72 65 6e 63 65 73 | 20 77 69 74 68 69 6e 20 |ferences| within |
|00003eb0| 79 6f 75 72 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |your app|lication|
|00003ec0| 20 77 69 74 68 6f 75 74 | 0d 77 6f 72 72 79 69 6e | without|.worryin|
|00003ed0| 67 20 61 62 6f 75 74 20 | 74 68 65 6d 20 70 65 72 |g about |them per|
|00003ee0| 73 69 73 74 69 6e 67 20 | 74 68 72 6f 75 67 68 20 |sisting |through |
|00003ef0| 61 20 73 61 76 65 2f 6f | 70 65 6e 20 63 79 63 6c |a save/o|pen cycl|
|00003f00| 65 2e 20 20 53 6f 2c 20 | 67 69 76 65 6e 20 74 68 |e.  So, |given th|
|00003f10| 65 20 61 62 6f 76 65 20 | 6d 65 73 73 61 67 69 6e |e above |messagin|
|00003f20| 67 0d 6d 65 63 68 61 6e | 69 73 6d 2c 20 75 73 69 |g.mechan|ism, usi|
|00003f30| 6e 67 20 65 69 74 68 65 | 72 20 63 68 69 6c 64 20 |ng eithe|r child |
|00003f40| 6e 75 6d 62 65 72 20 72 | 65 66 65 72 65 6e 63 65 |number r|eference|
|00003f50| 73 20 6f 72 20 68 61 6e | 64 6c 65 20 72 65 66 65 |s or han|dle refe|
|00003f60| 72 65 6e 63 65 73 20 69 | 73 20 65 71 75 61 6c 6c |rences i|s equall|
|00003f70| 79 20 76 61 6c 69 64 2e | 0d 57 68 61 74 65 76 65 |y valid.|.Whateve|
|00003f80| 72 20 73 65 65 6d 73 20 | 65 61 73 69 65 73 74 20 |r seems |easiest |
|00003f90| 66 6f 72 20 61 20 70 61 | 72 74 69 63 75 6c 61 72 |for a pa|rticular|
|00003fa0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 69 73 20 | applica|tion is |
|00003fb0| 74 68 65 20 6f 6e 65 20 | 74 6f 20 75 73 65 2e 0d |the one |to use..|
|00003fc0| 0d 0d 54 68 65 72 65 20 | 69 73 20 61 20 73 74 61 |..There |is a sta|
|00003fd0| 6e 64 61 72 64 20 73 65 | 74 20 6f 66 20 6d 65 73 |ndard se|t of mes|
|00003fe0| 73 61 67 65 73 20 70 61 | 73 73 65 64 20 74 6f 20 |sages pa|ssed to |
|00003ff0| 6f 62 6a 65 63 74 73 2e | 20 20 54 68 65 20 61 62 |objects.|  The ab|
|00004000| 6f 76 65 20 6d 65 73 73 | 61 67 65 20 69 73 20 6a |ove mess|age is j|
|00004010| 75 73 74 20 6f 6e 65 20 | 6f 66 20 74 68 65 73 65 |ust one |of these|
|00004020| 2e 0d 53 65 65 20 44 6f | 54 72 65 65 4f 62 6a 4d |..See Do|TreeObjM|
|00004030| 65 74 68 6f 64 20 66 6f | 72 20 61 20 63 6f 6d 70 |ethod fo|r a comp|
|00004040| 6c 65 74 65 20 6c 69 73 | 74 20 6f 66 20 73 74 61 |lete lis|t of sta|
|00004050| 6e 64 61 72 64 20 6d 65 | 73 73 61 67 65 73 20 61 |ndard me|ssages a|
|00004060| 6e 64 20 64 65 73 63 72 | 69 70 74 69 6f 6e 73 2e |nd descr|iptions.|
|00004070| 0d 0d 0d 08 0e 00 67 00 | 00 00 00 00 0b 00 09 00 |......g.|........|
|00004080| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 01 85 00 |........|........|
|00004090| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000040a0| 00 01 91 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|000040b0| 00 00 00 00 00 01 96 00 | 0b 00 09 00 04 05 00 00 |........|........|
|000040c0| 09 00 00 00 00 00 00 00 | 00 01 9f 00 0b 00 09 00 |........|........|
|000040d0| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 01 a4 00 |........|........|
|000040e0| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000040f0| 00 01 ad 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|00004100| 00 00 00 00 00 01 b2 00 | 0b 00 09 00 04 05 00 00 |........|........|
|00004110| 09 00 00 00 00 00 00 00 | 00 01 bd 00 0b 00 09 00 |........|........|
|00004120| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 01 c2 00 |........|........|
|00004130| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004140| 00 01 ce 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|00004150| 00 00 00 00 00 06 a6 00 | 0b 00 09 00 04 05 00 00 |........|........|
|00004160| 09 00 00 00 00 00 00 00 | 00 06 b0 00 0b 00 09 00 |........|........|
|00004170| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 0b 56 00 |........|......V.|
|00004180| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004190| 00 0b 61 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |..a.....|........|
|000041a0| 00 00 00 00 00 0b 76 00 | 0b 00 09 00 04 05 00 00 |......v.|........|
|000041b0| 09 00 00 00 00 00 00 00 | 00 0b 81 00 0b 00 09 00 |........|........|
|000041c0| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 0b 93 00 |........|........|
|000041d0| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000041e0| 00 0b 9e 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|000041f0| 00 00 00 00 00 0b e6 00 | 0b 00 09 00 04 05 00 00 |........|........|
|00004200| 09 00 00 00 00 00 00 00 | 00 0b f1 00 0b 00 09 00 |........|........|
|00004210| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 0d 7d 00 |........|......}.|
|00004220| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004230| 00 0d 88 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|00004240| 00 00 00 00 00 11 bc 00 | 0b 00 09 00 04 05 00 00 |........|........|
|00004250| 09 00 00 00 00 00 00 00 | 00 11 c7 00 0b 00 09 00 |........|........|
|00004260| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 12 09 00 |........|........|
|00004270| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004280| 00 12 14 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|00004290| 00 00 00 00 00 12 dd 00 | 0b 00 09 00 04 05 00 00 |........|........|
|000042a0| 09 00 00 00 00 00 00 00 | 00 12 e9 00 0b 00 09 00 |........|........|
|000042b0| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 12 fd 00 |........|........|
|000042c0| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000042d0| 00 13 09 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|000042e0| 00 00 00 00 00 13 1a 00 | 0b 00 09 00 04 05 00 00 |........|........|
|000042f0| 09 00 00 00 00 00 00 00 | 00 13 26 00 0b 00 09 00 |........|..&.....|
|00004300| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 13 6b 00 |........|......k.|
|00004310| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004320| 00 13 77 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |..w.....|........|
|00004330| 00 00 00 00 00 13 c0 00 | 0b 00 09 00 04 05 00 00 |........|........|
|00004340| 09 00 00 00 00 00 00 00 | 00 13 cb 00 0b 00 09 00 |........|........|
|00004350| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 13 dd 00 |........|........|
|00004360| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004370| 00 13 e9 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|00004380| 00 00 00 00 00 14 d9 00 | 0b 00 09 00 04 05 00 00 |........|........|
|00004390| 09 00 00 00 00 00 00 00 | 00 14 e5 00 0b 00 09 00 |........|........|
|000043a0| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 15 01 00 |........|........|
|000043b0| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000043c0| 00 15 0d 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|000043d0| 00 00 00 00 00 16 51 00 | 0b 00 09 00 04 05 00 00 |......Q.|........|
|000043e0| 09 00 00 00 00 00 00 00 | 00 16 5c 00 0b 00 09 00 |........|..\.....|
|000043f0| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 19 38 00 |........|......8.|
|00004400| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004410| 00 19 3f 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |..?.....|........|
|00004420| 00 00 00 00 00 19 41 00 | 0b 00 09 00 04 05 00 00 |......A.|........|
|00004430| 09 00 00 00 00 00 00 00 | 00 19 48 00 0b 00 09 00 |........|..H.....|
|00004440| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 19 c8 00 |........|........|
|00004450| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004460| 00 19 cf 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|00004470| 00 00 00 00 00 1b fa 00 | 0b 00 09 00 04 05 00 00 |........|........|
|00004480| 09 00 00 00 00 00 00 00 | 00 1c 04 00 0b 00 09 00 |........|........|
|00004490| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 1c 62 00 |........|......b.|
|000044a0| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000044b0| 00 1c 6c 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |..l.....|........|
|000044c0| 00 00 00 00 00 20 8b 00 | 0b 00 09 00 04 05 00 00 |..... ..|........|
|000044d0| 09 00 00 00 00 00 00 00 | 00 20 95 00 0b 00 09 00 |........|. ......|
|000044e0| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 21 69 00 |........|.....!i.|
|000044f0| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004500| 00 21 73 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.!s.....|........|
|00004510| 00 00 00 00 00 22 4f 00 | 0b 00 09 00 04 05 00 00 |....."O.|........|
|00004520| 09 00 00 00 00 00 00 00 | 00 22 59 00 0b 00 09 00 |........|."Y.....|
|00004530| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 25 c9 00 |........|.....%..|
|00004540| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004550| 00 25 d7 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.%......|........|
|00004560| 00 00 00 00 00 26 03 00 | 0b 00 09 00 04 05 00 00 |.....&..|........|
|00004570| 09 00 00 00 00 00 00 00 | 00 26 0e 00 0b 00 09 00 |........|.&......|
|00004580| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 26 3c 00 |........|.....&<.|
|00004590| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000045a0| 00 26 45 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.&E.....|........|
|000045b0| 00 00 00 00 00 26 7f 00 | 0b 00 09 00 04 05 00 00 |.....&..|........|
|000045c0| 09 00 00 00 00 00 00 00 | 00 26 89 00 0b 00 09 00 |........|.&......|
|000045d0| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 26 9e 00 |........|.....&..|
|000045e0| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000045f0| 00 26 ac 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.&......|........|
|00004600| 00 00 00 00 00 27 3d 00 | 0b 00 09 00 04 05 00 00 |.....'=.|........|
|00004610| 09 00 00 00 00 00 00 00 | 00 27 4b 00 0b 00 09 00 |........|.'K.....|
|00004620| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 27 f3 00 |........|.....'..|
|00004630| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004640| 00 27 fe 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.'......|........|
|00004650| 00 00 00 00 00 28 b3 00 | 0b 00 09 00 04 05 00 00 |.....(..|........|
|00004660| 09 00 00 00 00 00 00 00 | 00 28 c1 00 0b 00 09 00 |........|.(......|
|00004670| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 28 c9 00 |........|.....(..|
|00004680| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004690| 00 28 d2 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.(......|........|
|000046a0| 00 00 00 00 00 28 e8 00 | 0b 00 09 00 04 05 00 00 |.....(..|........|
|000046b0| 09 00 00 00 00 00 00 00 | 00 28 f6 00 0b 00 09 00 |........|.(......|
|000046c0| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 29 3b 00 |........|.....);.|
|000046d0| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000046e0| 00 29 44 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.)D.....|........|
|000046f0| 00 00 00 00 00 29 86 00 | 0b 00 09 00 04 05 00 00 |.....)..|........|
|00004700| 09 00 00 00 00 00 00 00 | 00 29 90 00 0b 00 09 00 |........|.)......|
|00004710| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 2e c6 00 |........|........|
|00004720| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004730| 00 2e d2 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |........|........|
|00004740| 00 00 00 00 00 34 81 00 | 0b 00 09 00 04 05 00 00 |.....4..|........|
|00004750| 09 00 00 00 00 00 00 00 | 00 34 8d 00 0b 00 09 00 |........|.4......|
|00004760| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 34 d5 00 |........|.....4..|
|00004770| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004780| 00 34 e1 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.4......|........|
|00004790| 00 00 00 00 00 36 38 00 | 0b 00 09 00 04 05 00 00 |.....68.|........|
|000047a0| 09 00 00 00 00 00 00 00 | 00 36 3f 00 0b 00 09 00 |........|.6?.....|
|000047b0| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 36 56 00 |........|.....6V.|
|000047c0| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|000047d0| 00 36 5d 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.6].....|........|
|000047e0| 00 00 00 00 00 36 69 00 | 0b 00 09 00 04 05 00 00 |.....6i.|........|
|000047f0| 09 00 00 00 00 00 00 00 | 00 36 75 00 0b 00 09 00 |........|.6u.....|
|00004800| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 37 e6 00 |........|.....7..|
|00004810| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004820| 00 37 ed 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.7......|........|
|00004830| 00 00 00 00 00 38 90 00 | 0b 00 09 00 04 05 00 00 |.....8..|........|
|00004840| 09 00 00 00 00 00 00 00 | 00 38 9c 00 0b 00 09 00 |........|.8......|
|00004850| 04 00 00 00 09 00 00 00 | 00 00 00 00 00 3b f9 00 |........|.....;..|
|00004860| 0b 00 09 00 04 05 00 00 | 09 00 00 00 00 00 00 00 |........|........|
|00004870| 00 3c 08 00 0b 00 09 00 | 04 00 00 00 09 00 00 00 |.<......|........|
|00004880| 00 00 00                |                         |...     |        |
+--------+-------------------------+-------------------------+--------+--------+